Vinkius

Insomnia MCP for AI Agents. Control your entire API lifecycle from text.

Insomnia (Collaborative API Design) brings your entire API design process into conversation. List organizations, projects, and files across Insomnia Cloud. Your agent can pull full OpenAPI specifications, audit mock server statuses, and track team progress without you ever touching the desktop app.

Insomnia MCP is compatible with Claude Claude
Insomnia MCP is compatible with ChatGPT ChatGPT
Insomnia MCP is compatible with Cursor Cursor
Insomnia MCP is compatible with Gemini Gemini
Insomnia MCP is compatible with Windsurf Windsurf
Insomnia MCP is compatible with VS Code VS Code
Insomnia MCP is compatible with JetBrains JetBrains
Insomnia MCP is compatible with Vercel Vercel
See Vinkius in Action

Give Claude and any AI agent real-world access

Discovering Project Structure

List all organizations and team projects to understand the full scope of API designs across multiple teams.

Retrieving File Content

Get the exact content, including OpenAPI/Swagger specs or request collections, for any specific design file in your project.

Auditing Configurations

Review environment variables and list active mock servers to confirm that testing stages are configured correctly.

Tracking Team Progress

Identify team members, check user roles, or review branches to see who is working on what feature.

Analyzing AI Usage

Query usage metrics and metadata surrounding previous AI-powered requests and test suggestions within the organization.

Waiting for input…

AI Agent
Insomnia

What AI agents can do with Insomnia (Collaborative API Design) with 10 Tools

Use these tools to list organizational units, retrieve specific file contents, check environment variables, monitor mock servers, and track team progress across your entire API portfolio.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Insomnia (Collaborative API Design) MCP

List Orgs

Lists every organization in Insomnia Cloud, providing the necessary ID to proceed with project or file actions.

List Projects

Retrieves a list of all team projects within an organization, which group related...

List Files

Locates specific files in a project by name or type, including API definitions and...

Get File

Pulls the full details of an Insomnia file, returning its complete content payload...

List Branches

Tracks collaborative progress by listing all available feature branches attached to...

List Collaborators

Identifies all registered members in the organization, including their roles and access levels.

List Ai Requests

Lists usage metrics and metadata for AI-powered API requests, showing generated specs and suggested tests.

Get User

Retrieves the authenticated Insomnia user's profile details, including their current...

List Environments

Lists all defined environments within a project, showing key variables like base...

List Mocks

Provides an inventory of mock servers in a project, including their operational...

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Insomnia MCP is compatible with Claude

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Insomnia integration is available immediately — no restart needed.

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 each call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Insomnia (Collaborative API Design), then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,200+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Connections are secured and governed automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog weekly
Insomnia MCP server cover

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 each call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

The Pain of Context Switching in API Development Solved with Vinkius AI Gateway

Today, checking an API definition means opening Insomnia. Then you click the project, navigate to the specific file, and if you need a variable, you jump over to the environment settings tab. If you want to share that spec, you copy-paste JSON data into Slack or Jira. It’s clicking, navigating, copying, pasting—a multi-step, manual process just to get one piece of information.

With this MCP, all those steps vanish. You simply ask your agent a question like, 'Give me the full OpenAPI spec for the payments file.' The platform handles finding the file, extracting the content, and delivering it straight to your conversation window. It's instant retrieval.

Get Live API Specs with `get_file`

You no longer have to open the Insomnia application just to check a payload or verify an endpoint definition. You can use your agent to execute `list_files`, find the target, and then run `get_file`. This pulls the exact content into your chat stream.

The API specification is now a conversational asset, not a file locked inside a GUI. It changes how fast you iterate and debug.

What your AI can actually do with this

You handle complex APIs all day long. Usually, that means jumping between a documentation page, a project dashboard, and a local editor just to check an environment variable or grab a specific request payload. This MCP lets your agent take over that context switching. You can ask it things like, 'Show me the full spec for the Payments API file' or 'What are the active mock servers in the Inventory project?' Your AI client pulls all that data—the org structure, the environment variables, and the OpenAPI specs—and gives you a clean answer right where you are typing.

It’s about getting answers on demand, not navigating menus. By connecting to Vinkius, you get access to this entire catalog of specialized connectors, making your whole development stack accessible through natural conversation.

Built · Hosted · Managed by Vinkius Insomnia-MCP - Manage API Designs & Specs
Server ID 019d75b9-d21b-71f0-9c9d-fb4fde2e136b
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

How do I list all my Insomnia projects using the Insomnia (Collaborative API Design) MCP? +

You use the list_projects tool. This function retrieves a comprehensive list of every team project within your organization, giving you their names and unique IDs.

Can I check mock server status with Insomnia (Collaborative API Design) MCP? +

Yes, run the list_mocks tool. It provides a list of all mock servers linked to your project, including their current operational status and public URLs.

How do I find out which team members have access? (Insomnia (Collaborative API Design) MCP) +

Use the list_collaborators tool. This function lists all registered users in your organization, showing their roles and specific access levels.

What if I need to see variable counts for different environments? (Insomnia (Collaborative API Design) MCP) +

Run list_environments. This tool lists all project environments and shows the associated variable count, helping you confirm which configurations are available.

Does this MCP support GraphQL or only REST APIs? +

No. The Insomnia (Collaborative API Design) MCP supports a wide range of protocols including REST, GraphQL, gRPC, and WebSockets, as listed in the tool descriptions.