How to Use the GlobalGiving MCP in Windsurf

Q: How does Windsurf run multi-step searches on GlobalGiving using the MCP Server?

Windsurf uses its Cascade agent to chain tools like listallprojects and getprojectdetails in a single execution. It reads the initial output, extracts the project IDs, and fetches the full metadata without requiring you to write intermediate prompts.

Q: Can I use Windsurf to build a custom dashboard with GlobalGiving data?

Yes. Windsurf reads your local workspace files, calls searchnonprofitprojects to get the raw JSON, and writes the UI code to render the charity metrics directly. It handles both the data fetching and the frontend generation.

Q: How does Windsurf and its Cascade agent handle connection issues with the GlobalGiving MCP integration?

Cascade runs verifyapiconnection to check the endpoint status before executing complex search sequences. If the connection fails, Windsurf displays the exact API error in the chat panel so you can fix your credentials.

Q: How do I configure this integration in my editor?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. Once saved, Cascade auto-discovers all twelve endpoints and makes them available for your next prompt.

Track nonprofit funding data and discover global initiatives directly inside Windsurf using Cascade's autonomous MCP agent chains.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade chains GlobalGiving queries to map active projects

Cascade uses `list_projects_by_country` to find regional initiatives and automatically feeds those IDs into `get_project_details` without waiting for your next prompt. This lets Windsurf map out active campaigns, funding goals, and remaining budgets in a single run. You don't have to manually copy and paste IDs between steps. The agent analyzes the returned JSON, spots the highest-need regions, and runs `get_charity_details` to verify the organization's standing before presenting the final list.

Target specific sectors using the Windsurf MCP Server

The Windsurf MCP Server exposes niche search tools like `find_education_initiatives`, `find_environment_initiatives`, and `find_health_initiatives` to target specific sectors. Cascade reads your workspace context, matches it to these thematic tools, and pulls live project data instantly. If you are building a charity widget, Cascade queries these endpoints, parses the active donation links, and writes the UI components directly into your editor. You get real-world nonprofit data wired directly into your code.

Run multi-step theme audits with Cascade

Cascade checks the active themes on the platform with `list_project_themes` and then runs `list_projects_by_theme` to pull matching campaigns. It tracks crowdfunding progress by comparing current funding against target goals across hundreds of initiatives. The agent processes these large datasets locally inside your IDE. It flags projects nearing their goals so you can build features that highlight urgent funding needs.

Setup guide

Set up GlobalGiving 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 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

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 GlobalGiving payment history." If connected, Cascade will call the GlobalGiving tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "globalgiving-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 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 Windsurf

Windsurf uses its Cascade agent to chain tools like `list_all_projects` and `get_project_details` in a single execution. It reads the initial output, extracts the project IDs, and fetches the full metadata without requiring you to write intermediate prompts.

Yes. Windsurf reads your local workspace files, calls `search_nonprofit_projects` to get the raw JSON, and writes the UI code to render the charity metrics directly. It handles both the data fetching and the frontend generation.

Cascade runs `verify_api_connection` to check the endpoint status before executing complex search sequences. If the connection fails, Windsurf displays the exact API error in the chat panel so you can fix your credentials.

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` key. Once saved, Cascade auto-discovers all twelve endpoints and makes them available for your next prompt.

All public charity metadata and project funding metrics are processed locally inside Windsurf's secure sandbox. No proprietary code or API tokens are sent back to external servers, keeping your integration keys safe.

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