Insomnia MCP. Manage API designs and collections via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Insomnia (Collaborative API Design) MCP Server manages your API design lifecycle. List organizations, projects, and files, and audit API specs using natural conversation.
Fetch OpenAPI specifications, check environment variables, and monitor mock server statuses without opening the desktop app. It's full control of API development, right from your agent.
What your AI agents can do
Get file
Gets the full details of an Insomnia file, including its content, type (spec/collection), and version history.
Get user
Returns the authenticated Insomnia user's profile, including their username, email, plan, and organization memberships.
List ai requests
Lists metadata and specs for API requests generated by Insomnia's AI features.
Fetch the full content of any API design file, including OpenAPI specs and collection JSON, using get_file.
Get the authenticated user's profile and list all members and their roles in the organization using get_user and list_collaborators.
List metadata and specs generated by AI interactions within your Insomnia organization using list_ai_requests.
List API file branches to see collaborative progress and status across parallel feature development lines using list_branches.
List all defined environments and count their variables to check stage-specific configurations like base URLs using list_environments.
List all files, projects, and organizations to locate specific API specifications, collections, or design documents using list_files and list_projects.
List active mock servers in a project to verify URLs, operational states, and endpoints using list_mocks.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Insomnia (Collaborative API Design) MCP Server: 10 Tools
These tools let your AI client navigate and extract data from every part of your Insomnia Cloud workspace, from single files to entire organizations.
019d75b9get file
Gets the full details of an Insomnia file, including its content, type (spec/collection), and version history.
019d75b9get user
Returns the authenticated Insomnia user's profile, including their username, email, plan, and organization memberships.
019d75b9list ai requests
Lists metadata and specs for API requests generated by Insomnia's AI features.
019d75b9list branches
Lists branches for a specific API file, tracking collaborative progress across different feature versions.
019d75b9list collaborators
Returns a list of members in the organization, detailing their usernames, emails, roles, and access levels.
019d75b9list environments
Lists all environments in a project, showing their names and the variable counts for different stages.
019d75b9list files
Lists all files in a project, providing names, types (spec/collection), and last modified dates.
019d75b9list mocks
Lists mock servers in a project, providing their names, URLs, and current operational statuses.
019d75b9list orgs
Lists all organizations on Insomnia Cloud, providing names, IDs, and member counts.
019d75b9list projects
Lists all team projects in an organization, grouping related API specs, collections, and environments.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Insomnia (Collaborative API Design), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Manages your API design lifecycle with Insomnia Cloud. Your AI client lets you list organizations, projects, and files, and audit API specs using natural conversation. You can fetch OpenAPI specifications, check environment variables, and monitor mock server statuses without opening the desktop app. It's full control of API development, right from your agent.
Inspect API Definitions
Use get_file to pull the full content of any API design file. You can see its type, its content, and even its version history.
Audit Team Accessget_user returns your authenticated Insomnia user profile, giving you your username, email, plan, and what organizations you belong to. list_collaborators returns a list of organization members, detailing their usernames, emails, roles, and access levels.
Review AI Usage Metricslist_ai_requests lets you list metadata and specs for API requests that Insomnia's AI features generated within your organization.
Track Feature Developmentlist_branches lists branches for a specific API file, showing you collaborative progress across different feature versions.
Manage Deployment Variableslist_environments lists all environments in a project, showing you their names and counting the variables for different stages, like base URLs.
Find API Assetslist_files lists all files in a project, giving you their names, types (spec/collection), and the last time they were modified. list_projects lists all team projects in an organization, grouping related API specs, collections, and environments. list_orgs lists all organizations on Insomnia Cloud, providing names, IDs, and member counts.
Check Mock Endpoint Statuslist_mocks lists mock servers in a project, letting you check their names, URLs, and current operational statuses.
How Insomnia MCP Works
- 1 Subscribe to the server and input your Insomnia Personal Access Token.
- 2 Your AI agent connects to the server and authenticates against your Insomnia Cloud account.
- 3 You tell your agent what you need—for example, 'List all projects in the Payments API organization.' — and it runs the necessary tools.
The bottom line is, your AI agent treats your entire Insomnia Cloud workspace like a set of APIs, letting you manage complex development processes using natural language.
Who Is Insomnia MCP For?
API Developers and Software Architects who spend time cross-referencing specs, environments, and project states. If you're tired of manually opening the Insomnia desktop app to check a configuration variable or pull an OpenAPI spec, this is for you. It lets you manage the entire lifecycle from a chat interface.
Pulls OpenAPI specs or request collections directly into the chat, eliminating the need to open the desktop app to pull definitions.
Audits mock server statuses and checks environment configurations to ensure test runs use the correct base URLs and tokens.
Monitors API design progress across multiple team projects and feature branches, seeing the full scope of the system state in one place.
What Changes When You Connect
- Get OpenAPI specs and request collections without opening the app. The
get_filetool pulls the exact content payload and full OpenAPI/Swagger specs directly into your chat window. - Audit deployment states instantly. You can use
list_environmentsto list environments and check variable counts, verifying if a project is running against the correct base URL or test token. - See who has access to what. Use
list_collaboratorsto list organization members, checking their roles and access levels to confirm proper team permissions. - Track parallel development. If a team is working on a major feature, use
list_branchesto see all feature branches and their status, preventing accidental merges of unfinished work. - Monitor live endpoints. The
list_mockstool lists mock servers, giving you the current operational status and URLs for testing before the real API is ready. - Map the entire API scope. Use
list_projectsandlist_filestogether to map out every API spec, collection, and design document within an entire organization.
Real-World Use Cases
Checking a Dependency Spec
A QA Engineer needs the latest OpenAPI spec for the Payments API. Instead of opening the Insomnia desktop app and navigating to the correct file, they ask their agent to use get_file. The agent retrieves the full, current OpenAPI 3.0 specification instantly, allowing the QA Engineer to validate endpoints right in the chat.
Onboarding a New Team Member
A Software Architect needs to know who has access to the Billing module. They use list_collaborators to identify all registered members. Then, they use list_projects to scope down to the 'Billing' project, confirming the correct roles and access levels for the new hire.
Validating a Staging Environment
A Developer is preparing a merge. They first use list_projects to select the target project. Then, they use list_environments to check the 'Staging' environment's variables, ensuring the correct base URL and auth token are set before committing code.
Debugging a Broken Test
A QA Engineer runs a test that fails due to a bad endpoint. They use list_mocks to check the mock server status. If the mock is listed as 'Inactive', they know the problem isn't the code, but the mock setup, saving hours of debugging.
The Tradeoffs
Manual App Navigation
The developer remembers they need the spec, so they open Insomnia, navigate to the project, find the correct file, and manually copy the OpenAPI JSON. This is slow and prone to human error.
→
Just ask your agent. Tell it, 'Get the OpenAPI spec for the Payments API file.' The agent uses get_file and sends the complete, current JSON payload directly to your chat.
Guessing the Environment Scope
A developer assumes the project is using the production base URL, but the system is actually running against the old 'Sandbox' environment. This causes hard-to-trace bugs.
→
Use list_environments first. It lists all environments and their variable counts. Then, ask the agent to confirm the active environment details to ensure you're checking the right stage.
Missing Team Context
A new hire needs to know who owns a specific API endpoint, but they don't know who to ask. They waste time pinging multiple team leads.
→
Run list_collaborators to get a list of all users, roles, and emails. You can then cross-reference this list with the project scope using list_projects.
When It Fits, When It Doesn't
Use this server if your main pain point is managing API design and development across multiple team members and environments. You need a single source of truth for specs, mock statuses, and project metadata. If you only need to check a single, isolated API endpoint and don't care about the project structure or who owns it, then a simple API wrapper might suffice. But if you need to know how the API was built, who approved it, where it runs (dev/staging/prod), and what its current specs are—this is the tool. It links the entire development lifecycle together.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking API Specs and Environments is a Click-Heavy Nightmare.
Right now, finding the status of a feature is a mess. You have to open Insomnia, jump between the project view, the environment manager, and the file browser. You manually check if the base URL is set correctly for staging, then open the specific file to pull the OpenAPI spec. If you're checking a branch, you have to navigate the Git-like branching view. It's a painful, multi-tab, copy-paste process.
With the Insomnia MCP Server, the whole process happens in chat. Ask your agent to 'Show me the specs for the Payments API in the Staging environment.' It runs `list_projects` and `list_environments` and then `get_file` to give you the single, accurate answer without touching the desktop app.
Insomnia (Collaborative API Design) MCP Server: Full Control.
You no longer have to switch context between five different Insomnia views—the project list, the collaborator list, the environment variables, the mock servers, and the file content. All that data is now accessible through the chat interface, triggered by simple commands.
This changes the game from 'Can I find this data?' to 'What do I want to know?' Your agent handles the complexity of traversing the API design graph for you.
Common Questions About Insomnia MCP
How do I use the `get_file` tool to get an OpenAPI spec? +
You provide the file ID or name to the agent. The agent executes get_file and returns the complete, raw content payload for the OpenAPI or Swagger specification. This means you get the full spec, not just a preview.
What is the difference between `list_files` and `list_projects`? +
list_projects shows the high-level containers—the overall API grouping. list_files lists the specific assets inside a project, like individual OpenAPI specs or request collections.
Can I check the status of mock servers using `list_mocks`? +
Yes. list_mocks lists all mock servers in a project and reports their current operational status (Active/Inactive) and their hosted URLs. This is crucial for QA testing.
Does `list_environments` show all API keys? +
It shows the environment name and the variable count. While it confirms the presence of variables (like base URLs or tokens), you must use the agent to view the actual sensitive values.
How does `list_branches` help with team collaboration? +
list_branches tracks the history of an API file, letting you see if a specific feature is on a dedicated branch and what its current status is, which is essential for coordinating merges.
How do I use `list_collaborators` to audit team roles and permissions? +
The list_collaborators tool returns usernames, emails, roles, and access levels for all members. This lets you audit who has access and what their specific permissions are in the organization.
What does `get_user` provide about my current API usage context? +
It returns your authenticated Insomnia user profile, including your username, email, plan, and membership details. You can use this to confirm your account status and organizational alignment.
Can `list_ai_requests` help me track API quality and suggestions? +
Yes, list_ai_requests exposes usage metrics and metadata about AI interactions. You can list AI-generated specs and test suggestions to improve your overall API quality.
Can I fetch full OpenAPI specifications through my agent? +
Yes. Use the get_file tool 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 tool 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 tool to retrieve all mock servers linked to your projects. Your agent will report their current operational state, names, and hosted URLs for testing purposes.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Builder
Automate Builder.io headless CMS workflows — generate content blocks, update models, and orchestrate visual components directly from any AI agent.
Alchemy
Manage blockchain data — audit wallets, NFTs, and transactions via AI.
Weaviate
Search and manage vector data on Weaviate — the AI-native database for building production-grade AI applications.
You might also like
Fintoc
Access bank accounts, movements, and initiate transfers via AI agents with Fintoc.
Musixmatch Alternative
Access the world's largest lyrics database — search tracks, retrieve synchronized subtitles, and explore global music charts directly from your AI agent.
Kevel
Manage ad campaigns, inventory, and creatives via the Kevel Management API.