How to Use the ReliefWeb MCP in Windsurf

Q: Can Windsurf use ReliefWeb data to update my local database?

Yes. Cascade can run a script to fetch data via getdisasters and write it to your local files. It maps the API response fields directly into your project structure.

Q: How do I filter ReliefWeb reports using Windsurf?

You tell Cascade to use getreports with specific parameters like country or theme. It handles the API query construction and displays the results in your chat window.

Q: Can I search for specific organization types?

Yes. Use getorganizations to list valid entities. Cascade can then pass those IDs into getreports to narrow your view.

Use the ReliefWeb MCP Server in Windsurf to pull live crisis data directly into your coding context.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ReliefWeb MCP to Windsurf

Create your Vinkius account to connect ReliefWeb to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ReliefWeb with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Fetch real-time disaster intelligence

Cascade uses `get_disasters` to pull active event data into your open files. It reads the disaster type and affected region so you can build logic based on current ground conditions. Stop searching through browser tabs for updates. When you give Cascade a goal, it hits the API and injects the raw data into your editor immediately.

Automate report retrieval in Windsurf

The `get_reports` tool lets Cascade search for specific humanitarian summaries using your natural language prompts. It grabs the exact metadata you need for your technical analysis. Windsurf chains these results with `get_report` to fetch specific details. You get the full context without leaving the IDE.

Query humanitarian job listings

Your agent uses `get_jobs` to pull live postings from the ReliefWeb database. It parses the location and organization data to match your specific search criteria. Cascade handles the filtering automatically. You see the latest opportunities as structured data in your workspace.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "reliefweb-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 ReliefWeb. 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 ReliefWeb 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 ReliefWeb MCP in Windsurf

Yes. Cascade can run a script to fetch data via `get_disasters` and write it to your local files. It maps the API response fields directly into your project structure.

You tell Cascade to use `get_reports` with specific parameters like country or theme. It handles the API query construction and displays the results in your chat window.

No. The connection works without manual authentication keys. Vinkius manages the transport so you can start querying immediately.

Yes. Use `get_organizations` to list valid entities. Cascade can then pass those IDs into `get_reports` to narrow your view.

The server only touches public humanitarian metadata. Your local files remain on your machine, and the MCP connection acts as a direct pipe for specific, non-sensitive disaster reports.

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