How to Use the Apidog MCP in Windsurf

Q: How do I add the Apidog MCP Server to my Windsurf configuration?

Edit your /.codeium/windsurf/mcpconfig.json file to add this server under the mcpServers key, or use the Cascade settings UI. Once saved, click refresh in the panel, and Cascade will instantly find the new tools.

Q: Can Windsurf Cascade write API tests using my Apidog schemas?

Yes. Cascade uses listschemas to pull your data models and then writes Jest or Pytest suites directly in your workspace. It handles the entire setup without you copy-pasting code blocks.

Q: Does Windsurf support the Apidog MCP exportopenapi tool?

Yes, Cascade calls exportopenapi whenever you ask it to analyze your entire API structure. It reads the raw JSON output to plan large-scale code migrations or write client SDKs.

Give Cascade the power to pull live Apidog API schemas and write your integration code in Windsurf without manual exports.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Apidog MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull live Apidog specs into Windsurf

Stop exporting JSONs from your workspace and pasting them into Cascade. This MCP Server lets Cascade use `list_projects` and `list_endpoints` to explore your backend API structure on the fly. When you ask Cascade to write a new API client, it queries `get_endpoint` to see the exact payload structure. It builds your TypeScript fetch calls or Python SDK code based on real-time spec data, not outdated local files.

Build entire client libraries with Cascade

Cascade chains tasks together without asking for permission at every step. It runs `export_openapi` to pull your entire Apidog project specification as a single OpenAPI 3.0 JSON. Once Cascade has the raw JSON, it writes the mock handlers, updates your environment variables, and generates the typescript types. It does this in one go, saving you from manual file management.

Instant DTO validation in your editor

When you are debugging a broken network request, tell Cascade to inspect the data transfer objects. The agent uses `list_schemas` to find the exact model defined in your Apidog project. Cascade compares your local database schema with the remote Apidog definition. It spots the missing fields instantly and fixes your code before you even run your local dev server.

Setup guide

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

mcp_config.json

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

Edit your `~/.codeium/windsurf/mcp_config.json` file to add this server under the `mcpServers` key, or use the Cascade settings UI. Once saved, click refresh in the panel, and Cascade will instantly find the new tools.

Yes. Cascade uses `list_schemas` to pull your data models and then writes Jest or Pytest suites directly in your workspace. It handles the entire setup without you copy-pasting code blocks.

Yes, Cascade calls `export_openapi` whenever you ask it to analyze your entire API structure. It reads the raw JSON output to plan large-scale code migrations or write client SDKs.

Cascade always gets the latest data because this tool queries the live Apidog API. Just tell Cascade to fetch the updated spec, and it will run `get_endpoint` to pull the fresh schema.

Your OpenAPI specs and project schemas never pass through third-party intermediate logging servers. Vinkius runs the server inside an isolated, ephemeral V8 sandbox that only talks directly to your local editor and the Apidog API.

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