How to Use the Insomnia (Collaborative API Design) MCP in Windsurf

Q: Can Windsurf use Insomnia (Collaborative API Design) to debug broken endpoints?

Yes. You can use listfiles to inspect your current API spec and then compare it against your mock servers using listmocks. This allows you to spot drift between your design and the actual implementation.

Q: How do I list my current API projects in Windsurf?

Call the listprojects tool after you have successfully authenticated your organization. It will return a list of all your active collections and design files currently stored in the cloud.

Use Insomnia (Collaborative API Design) directly in Windsurf to sync your API specs, manage mock servers, and debug requests.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Insomnia (Collaborative API Design) MCP to Windsurf

Create your Vinkius account to connect Insomnia (Collaborative API Design) 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 Insomnia (Collaborative API Design) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage your API workspace in Windsurf

Cascade pulls your team structure using `list_orgs` and `list_projects` to map out your architecture. You get instant visibility into where your specs live without leaving your editor. Once you pick a project, use `list_files` to grab the exact API definition you need. Cascade identifies the active file and brings the content into your context immediately.

Audit team collaboration and design progress

Keep track of who is working on what by running `list_collaborators` through your terminal. It shows you exactly who has access to your sensitive API design documents. Use `list_branches` to see how feature development is moving along. This lets you compare different versions of your specs without having to jump between browser tabs.

Validate environments and mock servers

Check your environment variables with `list_environments` to ensure your local testing matches production. It prevents those annoying configuration mismatches that break your builds. When you need to test against a stable endpoint, use `list_mocks` to see which servers are currently active. You can verify the status of these mocks before you start coding your client integrations.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "insomnia-collaborative-api-design-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 Insomnia. 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 Insomnia (Collaborative API Design) 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 Insomnia (Collaborative API Design) MCP in Windsurf

Add the server details into your Windsurf MCP configuration file or use the built-in settings panel. Once you save the endpoint, Cascade will automatically detect the tools and let you interact with your API data.

Yes. You can use `list_files` to inspect your current API spec and then compare it against your mock servers using `list_mocks`. This allows you to spot drift between your design and the actual implementation.

The server only accesses the data you explicitly request through the tools. It fetches your organization, project, and file metadata to help you design APIs, but it never stores your sensitive environment secrets on local disk.

Call the `list_projects` tool after you have successfully authenticated your organization. It will return a list of all your active collections and design files currently stored in the cloud.

This server accesses JSON-based API specifications and organization metadata. It operates on a read-only basis, ensuring your design documents and environment names remain under your control.

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