Insomnia (Collaborative API Design) Connector for AI agents.
10 live capabilities
Manage your collaborative API designs and mock statuses through natural conversation.
Waiting for input…
Why people use Insomnia (Collaborative API Design)
Insomnia (Collaborative API Design) for API Specification Management
This Connector lets you skip the clicking. You just ask your agent to pull the file or check the environment, and it gives you the data immediately. You get to stay in your code longer while keeping your API design in sync.
What Vinkius changes
You get a natural language interface for your entire Insomnia Cloud workspace.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Verifying staging environment variables
A developer asks their agent to find the base URL and auth tokens for the staging environment.
- Real-world use case 02
Checking mock status for a new feature
A QA engineer wants to know if the inventory mock is active.
- Real-world use case 03
Retrieving specs for a code review
An architect needs to see the latest OpenAPI spec for the payments API.
Complete set · 10capabilities
The complete Insomnia (Collaborative API Design) capability set.
These are the exact actions your AI can choose when you ask it to work with Insomnia (Collaborative API Design).
01—04
4 capabilities in this set.
Part of 10 available through Insomnia (Collaborative API Design).
- 01 Capability
List orgs
Find your organization ID to start looking for projects or files. It returns names and member counts.
- 02 Capability
List projects
See all team projects in an organization. This helps you navigate different API design environments.
- 03 Capability
List files
Locate specific API specs or request collections in a project. It returns names and types.
- 04 Capability
Get file
Pull the full content and version history of an API design file. This works for both specs and collections.
05—07
3 capabilities in this set.
Part of 10 available through Insomnia (Collaborative API Design).
- 05 Capability
List branches
See the status of different feature branches for your API specs. This tracks collaborative progress.
- 06 Capability
List collaborators
Check the usernames and roles of everyone in your organization. Use this to audit team permissions.
- 07 Capability
List ai requests
View metrics and metadata for AI-generated API requests. This helps you see AI-powered test suggestions.
08—10
3 capabilities in this set.
Part of 10 available through Insomnia (Collaborative API Design).
- 08 Capability
Get user
View your own profile, plan, and organization memberships. This helps audit your own identity context.
- 09 Capability
List environments
See the variables and base URLs for your different deployment stages. This shows your environment configurations.
- 10 Capability
List mocks
Find the names, URLs, and statuses of your mocks. This helps you verify your testing infrastructure.
Set up in minutes
One URL. Then ask Insomnia (Collaborative API Design) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Insomnia (Collaborative API Design) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Insomnia (Collaborative API Design), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Insomnia (Collaborative API Design) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Insomnia (Collaborative API Design) URL.
- Step 03
Save and start
Save the connection and enable Insomnia (Collaborative API Design) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"insomnia-collaborative-api-design": {
"url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Insomnia (Collaborative API Design)
Open Agent mode in chat and ask: "Using Insomnia (Collaborative API Design), help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"insomnia-collaborative-api-design": {
"url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Insomnia (Collaborative API Design)
Ask Copilot: "Using Insomnia (Collaborative API Design), help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"insomnia-collaborative-api-design": {
"url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Insomnia (Collaborative API Design)
Open Cascade and ask: "Using Insomnia (Collaborative API Design), help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"insomnia-collaborative-api-design": {
"url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Insomnia (Collaborative API Design)
Ask Cline: "Using Insomnia (Collaborative API Design), help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add insomnia-collaborative-api-design --transport http "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Insomnia (Collaborative API Design)
Ask Claude: "Using Insomnia (Collaborative API Design), show me...". 10 tools are ready
Where the request belongs
Work Insomnia can move forward.
This is for the API developer who's tired of clicking through nested folders to find a single spec, or the QA engineer who needs to verify mock statuses across multiple environments at a moment's notice.
API Developer
Uses this to pull OpenAPI specs and check request collections while staying inside their IDE.
QA Engineer
Checks mock statuses and environment variables to ensure test execution is accurate.
Software Architect
Monitors design progress across multiple team projects and feature branches to keep stakeholders informed.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsApiary
Manage your API design-first workflows via Apiary. read blueprints, publish docs, and run tests directly from your AI agent.
Reqres
Test your front-end against a real API. manage users, resources, and project records for prototyping and testing.
Postman
Design, test, and document APIs collaboratively with the world most popular API development platform used by millions of developers.
SwaggerHub
Connect your AI to SwaggerHub. Read OpenAPI specifications, explore domains, and manage your API design lifecycle natively from the terminal.
Apidog
Sync your Apidog workspace with your AI agent. list projects, fetch endpoint schemas, and export full OpenAPI specifications instantly.
Stoplight
Connect your AI to Stoplight. Design, document, and manage your API lifecycle, exploring workspaces and schemas effortlessly.
Bring your own AI
Change the model, client or framework. Keep Insomnia connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Insomnia.
The practical details behind the request, access and result.
How can I use the Insomnia (Collaborative API Design) MCP to manage my team's API specs?
You can use it to browse projects, find specific files, and pull full OpenAPI specifications directly into your chat. It makes it easy to get the information you need without leaving your agent.
Can I check my mock statuses with the Insomnia (Collaborative API Design) MCP?
Yes. You can ask your agent to list the mocks in a project, and it will provide you with their names, URLs, and current operational statuses.
Does the Insomnia (Collaborative API Design) MCP work with my existing Insomnia Cloud account?
It does. By connecting your Insomnia Cloud account with your Personal Access Token, the Connector gives your agent the ability to interact with your existing organizations, projects, and files.
How do I find environment variables using the Insomnia (Collaborative API Design) MCP?
Just ask your agent to list the environments for a specific project. It will return the environment names and the count of variables configured for each stage.
Can I see who has access to my projects using the Insomnia (Collaborative API Design) MCP?
Yes. You can ask the agent to list the collaborators in your organization, and it will show you the usernames, emails, and roles for all members.
Can I see the history of my API design files?
Yes, when you use the agent to get a specific file, it retrieves the full content along with the version history, so you can see how the design has evolved.
Can I fetch full OpenAPI specifications through my agent?
Yes. Use the get_file capability by providing the relevant Org, Project, and File IDs. Your agent will retrieve the exact content payload, allowing you to inspect or summarize the API structure directly in your workspace.
How do I see the environments defined in a team project?
The list_environments capability allows your agent to extract base environments scoped within a project. You'll see the environment names and variable counts, helping you identify available stages for your API calls.
Can my agent check if a mock server is currently online?
Absolutely. Use the list_mocks capability to retrieve all mock servers linked to your projects. Your agent will report their current operational state, names, and hosted URLs for testing purposes.
One connection away
Give your agent a direct line to Insomnia.
Connect Insomnia once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available