How to Use the Charity Navigator MCP in Mastra AI

Build resilient nonprofit evaluation workflows with Mastra AI and this MCP Server to automatically route donations based on financial health.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate due diligence with this MCP Server

The `get_charity` tool fetches detailed IRS tax filings, mission statements, and contact info by EIN. Your Mastra AI workflow grabs this baseline data as the first step in a larger evaluation pipeline. Network requests fail sometimes. If the API request times out, the framework's exponential backoff kicks in automatically. You don't have to write custom retry logic just to ensure you get the nonprofit's address and website.

Branch logic on advisory warnings

Calling `get_charity_advisories` pulls down any governance or fundraising warnings associated with an organization. You use this to drive conditional branching in your agent's execution path. When the workflow detects an active advisory, it routes the process to a human-in-the-loop approval step. Clean records bypass the manual check and proceed directly to the final funding recommendation.

Map broad causes to exact categories

Retrieving the full taxonomy requires the `get_categories` tool. It returns every valid cause area along with its parent category and unique identifier. Your agent uses these IDs to construct precise queries for downstream search operations. The built-in workflow engine guarantees the category mapping finishes completely before the next step attempts to filter charities by cause.

Setup guide

Set up Charity Navigator MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Charity Navigator tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "charity-navigator-mcp-client",
  servers: {
    "charity-navigator-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Charity Navigator Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Charity Navigator tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Charity Navigator transactions"
);
console.log(result.text);

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 Mastra AI

Install @mastra/mcp and instantiate a new client with your Vinkius endpoint. Call listTools() and spread the results directly into your agent's tool array. The framework auto-detects whether to use SSE or Streamable HTTP.

You can configure conditional branches based on the advisory status returned by the API. If an active warning appears, the workflow stops and triggers a notification. This prevents automated systems from approving problematic organizations.

The framework handles memory and state across workflow steps. Once an agent fetches a rating score, subsequent steps in that same execution can access the financial health metrics without making another network call.

Pass the state abbreviation into the search parameters. The agent can combine this with organization size limits and rating requirements to narrow down the results perfectly.

Vinkius executes the MCP server inside an ephemeral environment. Your workflow pulls EINs and advisory records through an encrypted tunnel that terminates immediately after the run. No persistent storage retains your evaluation criteria.

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