Insomnia (Collaborative API Design) MCP Server for Windsurf 10 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Insomnia (Collaborative API Design) through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Insomnia (Collaborative API Design) and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"insomnia-collaborative-api-design": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Insomnia (Collaborative API Design) MCP Server
Connect your Insomnia Cloud account to any AI agent and take full control of your collaborative API development and design lifecycle through natural conversation.
Windsurf's Cascade agent chains multiple Insomnia (Collaborative API Design) tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 10 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Organization & Project Management — List all organizations and team projects to navigate your API design and debugging environments effortlessly
- API File Inspection — Retrieve exact content payloads for design documents and request collections, including full OpenAPI/Swagger specifications
- Environment Audit — List project environments and variable counts to understand stage-specific configurations like base URLs and auth tokens
- Team Collaboration — Identify registered members and roles in your organization and track collaborative progress across parallel feature branches
- Mock Server Monitoring — Analyze deployed mock servers linked to your projects, including their operational states and hosted endpoints
- AI Insights — Query AI-powered request logs and test suggestions generated within your Insomnia organization to improve API quality
The Insomnia (Collaborative API Design) MCP Server exposes 10 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Insomnia (Collaborative API Design) to Windsurf via MCP
Follow these steps to integrate the Insomnia (Collaborative API Design) MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using Insomnia (Collaborative API Design)
Open Cascade and ask: "Using Insomnia (Collaborative API Design), help me...". 10 tools available
Why Use Windsurf with the Insomnia (Collaborative API Design) MCP Server
Windsurf provides unique advantages when paired with Insomnia (Collaborative API Design) through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 10 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Insomnia (Collaborative API Design) + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Insomnia (Collaborative API Design) MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Insomnia (Collaborative API Design) and generate models, types, or handlers based on real API responses
Live debugging: query Insomnia (Collaborative API Design) tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Insomnia (Collaborative API Design) and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Insomnia (Collaborative API Design) data with Cascade's code generation to scaffold entire features in minutes
Insomnia (Collaborative API Design) MCP Tools for Windsurf (10)
These 10 tools become available when you connect Insomnia (Collaborative API Design) to Windsurf via MCP:
get_file
Get full details of an Insomnia file including name, type, content (spec/collection JSON), and version history
get_user
Helps audit basic permission identity context. Get the authenticated Insomnia user profile. Returns username, email, plan, and org memberships
list_ai_requests
Exposes usage metrics and metadata surrounding Insomnia AI interactions. List AI-powered API requests generated in an Insomnia organization. Returns AI-generated specs and test suggestions
list_branches
Useful to track collaborative progress across multiple parallel feature branches. List branches of an Insomnia file. Git-like branching for API specs and collections. Returns branch names and statuses
list_collaborators
List members in an Insomnia organization. Returns usernames, emails, roles, and access levels
list_environments
Environments are the primary way Insomnia abstracts configuration, injecting values into execution payloads. List environments in an Insomnia project. Environments hold variables (base URLs, tokens) for different stages. Returns env names and variable counts
list_files
Use to locate the specific file_id for fetching API definitions. List files in an Insomnia project. Files include API specs (OpenAPI/Swagger), request collections, and design documents. Returns names, types, and last modified dates
list_mocks
List mock servers in an Insomnia project. Mock servers simulate API responses for testing. Returns mock names, URLs, and statuses
list_orgs
Use this to find the appropriate org_id needed for subsequent project or file operations. List all organizations on Insomnia Cloud. Insomnia (by Kong) is a leading API design, debugging, and testing tool supporting REST, GraphQL, gRPC, and WebSockets. Returns org names, IDs, and member counts
list_projects
Projects contain design files, requests, environments, and mock servers. List team projects in an Insomnia organization. Projects group API specs, collections, and environments. Returns project names and IDs
Example Prompts for Insomnia (Collaborative API Design) in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Insomnia (Collaborative API Design) immediately.
"List all my Insomnia projects in organization 'org-123'"
"Show me the OpenAPI spec for the 'Payments API' file"
"What are the active mock servers in our 'Inventory' project?"
Troubleshooting Insomnia (Collaborative API Design) MCP Server with Windsurf
Common issues when connecting Insomnia (Collaborative API Design) to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
Insomnia (Collaborative API Design) + Windsurf FAQ
Common questions about integrating Insomnia (Collaborative API Design) MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect Insomnia (Collaborative API Design) with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Insomnia (Collaborative API Design) to Windsurf
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.