How to Use the Charity Navigator MCP in Vercel AI SDK

Stream live nonprofit data and financial ratings directly into your React applications using this Vercel AI SDK compatible MCP Server.

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 Vercel AI SDK

Create your Vinkius account to connect Charity Navigator to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build live search interfaces with this MCP Server

The `search_charities` tool feeds directly into your Vercel AI SDK stream. Pass a user's prompt asking for highly rated animal shelters in Texas, and the agent immediately starts filtering by category, state, and rating score. Waiting for massive payloads to resolve is a terrible user experience. Your Next.js frontend renders the charity names, EINs, and mission statements as they arrive over the wire. Users see the results populating instantly on their screen.

Surface financial health metrics

Accessing deep historical data requires the `get_charity_ratings` tool. Your agent pulls the overall score, accountability metrics, and transparency history for any specific organization. This means you can build dynamic charts in your UI that update live as the LLM processes the response. The end user watches the financial trajectory of a nonprofit materialize without ever seeing a loading spinner.

Flag governance warnings instantly

The `get_charity_advisories` tool grabs active or removed warnings tied to a specific EIN. If a nonprofit has operational concerns, your agent knows about it immediately. You can trigger a UI alert component the second this data hits your application. Developers use this exact pattern to protect donors from sending money to organizations with red flags in their financial management.

Setup guide

Set up Charity Navigator MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Charity Navigator tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Charity Navigator transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Install the @ai-sdk/mcp package via npm. Initialize the connection using createMCPClient with your HTTP transport URL. Pass the resulting tools directly into your streamText function.

Yes, it handles streaming out of the box. As the agent calls the search function, the JSON response flows into your frontend components in real-time. Your users won't stare at a blank screen while the API fetches data.

The agent uses the categories tool to map user requests to specific cause IDs. It then applies those IDs to the search parameters automatically. You get precise filtering without writing custom mapping logic.

The search tool accepts a maximum page size of 1000 records. You can paginate through up to 10 pages per query. That gives you 10,000 total results per search operation.

Your Vercel application only transmits the specific EINs and search strings you request. Vinkius runs the connection inside a zero-trust V8 Isolate sandbox. The session dies the moment your stream closes, leaving no trace of the queried tax filings.

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