How to Use the Fastn MCP in Windsurf

Q: How does Cascade in Windsurf handle errors during a Fastn workflow execution?

Cascade polls getexecution to read the step trace the moment a run fails. It identifies the exact broken step in your Fastn pipeline and suggests a fix or modifies the input payload automatically.

Q: How do I check my API limits for Fastn inside Windsurf?

Ask Cascade to check your usage. It calls getquotadaily and getquotasummary to show you exactly how many runs you have left on your current plan.

Build, deploy, and trigger Fastn workflows autonomously using Cascade in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fastn MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build and deploy flows inside Windsurf

The `create_workflow` tool lets Cascade write and register your Fastn automation blueprints directly from your editor. Cascade reads your open files, maps out the step-by-step logic, and spins up new Fastn flows without you writing tedious JSON boilerplate. Once the structure looks correct, Cascade calls `publish_workflow` to push the changes live. You get instant deployment because this MCP Server handles the deployment handshake under the hood, letting your IDE manage the whole lifecycle.

Run and monitor executions with Cascade

The `execute_flow` tool triggers your live Fastn automation pipelines using the MCP Server interface directly from the Windsurf chat. Cascade feeds the necessary payload into the execution block, gets the run ID, and immediately begins polling the status. If a run hangs or hits a rate limit, Cascade uses `get_execution` to pull down the full step-by-step trace. It analyzes the failure points, and if things go completely sideways, it calls `cancel_execution` to stop wasted runs.

Manage credentials and quotas inside your IDE

The `store_credentials` tool stores API keys and connection tokens securely in Fastn from your Windsurf workspace via this MCP connection. Cascade keeps track of which connectors need authorization, setting up the plumbing so your automated runs do not fail on auth checks. To keep your usage in check, Cascade calls `get_quota_usage` to verify your remaining limits before kicking off massive batch runs. It handles token rotation via `rotate_credentials` when keys expire, keeping your pipelines running without manual intervention.

Setup guide

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

mcp_config.json

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

Cascade polls `get_execution` to read the step trace the moment a run fails. It identifies the exact broken step in your Fastn pipeline and suggests a fix or modifies the input payload automatically.

Yes. Cascade reads your local scripts, translates the logic into the correct JSON structure, and calls `create_workflow` to register it. It then deploys it using `publish_workflow` in one go.

Ask Cascade to check your usage. It calls `get_quota_daily` and `get_quota_summary` to show you exactly how many runs you have left on your current plan.

Yes. When a pipeline gets stuck, ask Cascade to stop it. It uses `list_executions` to find the active run ID and invokes `cancel_execution` instantly.

Your connector credentials are saved directly in the Fastn secure vault using `store_credentials`. They never pass through or get cached on Windsurf's servers, keeping your API keys safe from exposure.

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