How to Use the Charity Navigator MCP in Windsurf

Q: How do I filter Charity Navigator results using Windsurf?

You can use the getcategories tool to grab specific IDs for cause areas like health or animal welfare. Feed these IDs into the searchcharities function to narrow down your list.

Q: Can Windsurf pull full financial records from Charity Navigator?

Yes, the getcharity tool returns detailed financial data and tax filing info for specific EINs. Windsurf presents this data directly in your chat panel.

Q: Does Windsurf show historical rating trends from Charity Navigator?

Windsurf accesses the getcharityratings tool to display historical score changes. You get the full breakdown of financial health and impact scores over the years.

Use Windsurf to pull live charity ratings and financial data directly into your workspace for informed development.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Charity Navigator MCP to Windsurf

Create your Vinkius account to connect Charity Navigator to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Charity Navigator with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find nonprofits with Windsurf

Cascade uses `search_charities` to filter organizations by location, size, or rating. It handles the pagination for you so you get the full list of potential partners without manual searching. You'll get back names, EINs, and mission statements instantly. It keeps your context clean while you browse through thousands of verified entries.

Review financial health in Windsurf

Call `get_charity_ratings` to see the historical performance of any organization. You'll see how accountability and transparency scores shift over time, giving you a clear picture of their operational stability. This MCP Server provides the raw metrics needed to verify if a charity matches your project requirements. You won't have to leave your IDE to check their fiscal credibility.

Check for active advisories in Windsurf

Use `get_charity_advisories` to flag potential issues with governance or fundraising practices. It pulls active warnings so you know exactly which nonprofits have reported concerns. This tool ensures you aren't building for organizations with flagged operations. Cascade can cross-reference these alerts against your own project criteria automatically.

Setup guide

Set up Charity Navigator MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Charity Navigator MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Charity Navigator payment history." If connected, Cascade will call the Charity Navigator tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "charity-navigator-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Charity Navigator. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Charity Navigator now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Charity Navigator MCP in Windsurf

You can use the `get_categories` tool to grab specific IDs for cause areas like health or animal welfare. Feed these IDs into the `search_charities` function to narrow down your list.

Yes, the `get_charity` tool returns detailed financial data and tax filing info for specific EINs. Windsurf presents this data directly in your chat panel.

Windsurf accesses the `get_charity_ratings` tool to display historical score changes. You get the full breakdown of financial health and impact scores over the years.

The server returns the specific nature of the advisory, such as governance or financial management issues. You can then decide whether to proceed with that charity.

Your queries stay within the session between your IDE and the host. This MCP Server only processes nonprofit EINs, public financial metrics, and ratings; it never touches your personal user credentials.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript