How to Use the GlobalGiving MCP in Claude Code

Q: How do I connect the GlobalGiving MCP Server to Claude Code?

Run the claude mcp add command in your terminal, specifying the HTTP transport and the server URL. Claude Code writes this configuration to your local /.claude.json file and loads the tools instantly.

Q: Can I run automated scripts with Claude Code and GlobalGiving?

Yes. You can script Claude Code to execute searchnonprofitprojects headlessly, letting you export active campaign lists directly to CSV or JSON formats using standard terminal redirection.

Q: How does Claude Code verify that the GlobalGiving API is online?

It executes the verifyapiconnection tool directly from your shell. The agent returns a clean connection status and latency reading, allowing you to debug network issues without leaving the terminal.

Q: How can I search for specific sectors like education or health using the MCP client?

Use specialized tools like findeducationinitiatives or findhealthinitiatives directly from the CLI. Claude Code runs the search, filters the results, and displays the matching projects as a clean table in your terminal.

Pipe global charity metrics and campaign data straight to your terminal using Claude Code and the GlobalGiving 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 GlobalGiving MCP to Claude Code

Create your Vinkius account to connect GlobalGiving to Claude Code 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 GlobalGiving with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe terminal queries into backend databases

Claude Code runs `list_all_projects` and pipes the raw output directly into your database seed scripts. You can run CLI commands to filter projects by region with `list_projects_by_country` and instantly generate clean JSON files for your staging environments. This headless execution makes it easy to run automated checks. You can script the tool to run during your deployment phase, verifying that your production database matches the latest active campaign lists.

Automate CI/CD validation with the Claude Code MCP Server

The Claude Code MCP Server uses `verify_api_connection` to check endpoint availability before running your build pipelines. If the connection fails, the CLI alerts your on-call team, preventing broken API dependencies from reaching production. You can embed these checks directly into your GitHub Actions or custom bash scripts. The agent runs silently in the background, outputting structured logs that are easy to parse with standard terminal utilities.

Monitor campaign themes from the command line

Claude Code queries the platform's categorization using `list_project_themes` and searches specific sectors with `list_projects_by_theme`. It filters the terminal output to show only campaigns that match your criteria, like disaster relief or education. This direct access lets you run quick audits without opening a browser. You can chain these commands with other CLI tools to monitor funding progress and alert your team when specific milestones are met.

Setup guide

Set up GlobalGiving MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see globalgiving-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest GlobalGiving transactions." It will automatically discover and invoke the available GlobalGiving tools.

Terminal

claude mcp add --transport http globalgiving-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the GlobalGiving 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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "globalgiving-mcp": {
      "type": "url",
      "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 GlobalGiving. 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 GlobalGiving 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 GlobalGiving MCP in Claude Code

Run the `claude mcp add` command in your terminal, specifying the HTTP transport and the server URL. Claude Code writes this configuration to your local `~/.claude.json` file and loads the tools instantly.

Yes. You can script Claude Code to execute `search_nonprofit_projects` headlessly, letting you export active campaign lists directly to CSV or JSON formats using standard terminal redirection.

It executes the `verify_api_connection` tool directly from your shell. The agent returns a clean connection status and latency reading, allowing you to debug network issues without leaving the terminal.

Use specialized tools like `find_education_initiatives` or `find_health_initiatives` directly from the CLI. Claude Code runs the search, filters the results, and displays the matching projects as a clean table in your terminal.

Yes. Claude Code processes project themes, organization metrics, and connection status logs entirely on your local machine. Your API tokens are managed via local environment variables, ensuring no sensitive credentials travel over public networks.

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