Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Insomnia with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage API designs and collections via Insomnia. list organizations, projects, and files, and audit API specs.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete Insomnia capability set.

These are the exact actions your AI can choose when you ask it to work with Insomnia.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through Insomnia.

  1. 01

    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

  2. 02

    List collaborators

    List members in an Insomnia organization. Returns usernames, emails, roles, and access levels

  3. 03

    List mocks

    List mock servers in an Insomnia project. Mock servers simulate API responses for testing. Returns mock names, URLs, and statuses

  4. 04

    Get file

    Get full details of an Insomnia file including name, type, content (spec/collection JSON), and version history

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through Insomnia.

  1. 05

    Get user

    Helps audit basic permission identity context. Get the authenticated Insomnia user profile. Returns username, email, plan, and org memberships

  2. 06

    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

  3. 07

    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

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through Insomnia.

  1. 08

    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

  2. 09

    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 capability supporting REST, GraphQL, gRPC, and WebSockets. Returns org names, IDs, and member counts

  3. 10

    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

Observed, not estimated

847ms average. Fast in production.

Insomnia is checked daily against the live service.

Daily averagePeak 1139ms
Aug 24Today
Fastest day
722ms
Slowest day
1139ms
14-day trend
Improving-7%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Insomnia, so you can see the experience inside your AI.

It does not authenticate your account with Insomnia. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Insomnia Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Insomnia capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "insomnia-collaborative-api-design-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_llyGrXZujRu3thzxemiC8Hu0c2yGytKkiHgDZtDU/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Insomnia owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Loved By Devs

Suggestions