How to Use the Nango (Unified API & Integration Platform) MCP in Windsurf

Q: How does Windsurf use Nango (Unified API & Integration Platform) to debug broken integrations?

Cascade automatically calls listsyncs when you ask it to investigate integration issues. It matches failed sync jobs against active auth sessions retrieved via listconnections to find the root cause.

Q: Can Cascade automatically fix OAuth issues found by this MCP Server?

Cascade can identify expired sessions using getconnection and write the code to handle the refresh flow. However, it cannot bypass Nango's secure OAuth handshake which occurs safely outside your local workspace.

Q: Where do I configure the Nango (Unified API & Integration Platform) credentials inside Windsurf?

Add your API keys to the /.codeium/windsurf/mcpconfig.json file under the MCP configuration block. Once saved, Windsurf instantly exposes the toolset to Cascade without requiring an editor restart.

Q: How does listrecords help when writing frontend components in Cascade?

Cascade queries listrecords to fetch real payload examples from your connected integrations. This gives the agent actual data structures to work with, resulting in highly accurate component typing.

Audit OAuth connections and track live data syncs directly from Windsurf using the Cascade autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nango (Unified API & Integration Platform) MCP to Windsurf

Create your Vinkius account to connect Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit OAuth connections autonomously in Windsurf

The `list_connections` tool allows your Cascade agent to pull a clean inventory of every active user connection without leaving your editor. Cascade reads your workspace context, realizes a connection is failing, and immediately runs this tool to check the status. Instead of manual API debugging, you let the agent map out auth states using `get_connection`. It spots expired tokens instantly, saving you from digging through external dashboards during active coding sessions.

Track active data syncs using this MCP Server

The `list_syncs` tool exposes the real-time execution history and current status of your Nango data pipelines directly to your IDE. When you ask Cascade to fix a broken data pipeline, it chains this tool with other checks to pinpoint exactly where a sync stalled. You don't have to write custom logging scripts to monitor your data flows. Cascade reads the output of `list_records` to verify that the synchronized data actually matches your expected schema.

Map integration parameters without leaving Cascade

The `get_integration` tool provides Cascade with the exact configuration rules and endpoints defined for your active integrations. Having this metadata handy lets the agent write accurate code that respects your specific provider limits. Cascade uses `list_integrations` and `get_environment` to inspect your active runtime bounds before making configuration changes. This MCP Server setup prevents your agent from attempting invalid API calls that would trigger provider rate limits.

Setup guide

Set up Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) payment history." If connected, Cascade will call the Nango (Unified API & Integration Platform) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "nango-unified-api-integration-platform-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 Nango. 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 Nango (Unified API & Integration Platform) 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 Nango (Unified API & Integration Platform) MCP in Windsurf

Cascade automatically calls `list_syncs` when you ask it to investigate integration issues. It matches failed sync jobs against active auth sessions retrieved via `list_connections` to find the root cause.

Cascade can identify expired sessions using `get_connection` and write the code to handle the refresh flow. However, it cannot bypass Nango's secure OAuth handshake which occurs safely outside your local workspace.

Add your API keys to the `~/.codeium/windsurf/mcp_config.json` file under the MCP configuration block. Once saved, Windsurf instantly exposes the toolset to Cascade without requiring an editor restart.

Cascade queries `list_records` to fetch real payload examples from your connected integrations. This gives the agent actual data structures to work with, resulting in highly accurate component typing.

Your actual client secrets and OAuth credentials remain securely stored in your isolated Nango instance. Windsurf only interacts with metadata and record payloads returned via `get_connection`, keeping your raw credentials completely hidden from local logs.

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