Insomnia (Collaborative API Design)

Insomnia (Collaborative API Design) MCP Connector for Claude

A+

Manage API designs and collections via Insomnia — list organizations, projects, and files, and audit API specs.

10 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your Insomnia Cloud account to any AI agent and take full control of your collaborative API development and design lifecycle through natural conversation.

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

How it works

  1. Subscribe to this server
  2. Enter your Insomnia Personal Access Token
  3. Start managing your API lifecycle from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • API Developers — fetch OpenAPI specs and request collections directly through natural conversation without opening the desktop app
  • QA Engineers — audit mock server statuses and environment configurations to ensure accurate test execution
  • Software Architects — monitor API design progress across multiple team projects and feature branches efficiently
api-designrest-apigraphqldebuggingapi-testingwebsocket

10 tools expose this connector's capabilities to your AI agent.

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

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

get_file

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

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_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

get_user

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

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_mocks

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

See how to talk to your AI agent using Insomnia (Collaborative API Design).

List all my Insomnia projects in organization 'org-123'

I've found 4 projects in organization 'org-123': 'Payments API', 'User Authentication', 'Inventory Management', and 'External Webhooks'. Which one would you like to see files for?

Show me the OpenAPI spec for the 'Payments API' file

Retrieving file 'Payments API'… I've fetched the content. It contains a full OpenAPI 3.0 specification with 12 endpoints, including '/charge', '/refund', and '/dispute'. Would you like a summary of the available paths?

What are the active mock servers in our 'Inventory' project?

I've identified 2 mock servers in 'Inventory': 1) 'Production Mock' (Status: Active, URL: https://mock.insomnia.rest/inv-prod), 2) 'Beta Features' (Status: Inactive). Would you like to check the environment variables for the production mock?

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.

Related Connectors