How to Use the Insomnia (Collaborative API Design) MCP in VS Code Copilot

Q: How do I share the Insomnia (Collaborative API Design) configuration with my team in VS Code Copilot?

Create a .vscode/mcp.json file in your repository root and commit it. Every developer on your team using VS Code Copilot will automatically gain access to the configured tools.

Q: Can VS Code Copilot query multiple organizations using Insomnia (Collaborative API Design)?

Yes, the listorgs tool retrieves all active organizations on Insomnia Cloud. Copilot can switch between different org contexts to find the correct project files for your workspace.

Q: How does VS Code Copilot verify my API specs using Insomnia (Collaborative API Design)?

Your agent uses getfile to fetch the complete JSON spec. Copilot parses this data to validate your local endpoints and ensure your code matches the defined schema.

Q: Can Copilot check who has access to our API designs?

Yes, the listcollaborators tool retrieves the list of organization members along with their roles. Copilot uses this to audit permissions and verify access levels across your team.

Equip your entire team in VS Code Copilot with shared Insomnia API designs and environment configurations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Insomnia (Collaborative API Design) MCP to VS Code Copilot

Create your Vinkius account to connect Insomnia (Collaborative API Design) to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Insomnia (Collaborative API Design) with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync team API specs directly to VS Code Copilot

The `list_projects` tool lets your agent index every API design project across your organization. This gives Copilot immediate context on where your schemas are located without forcing team members to search manually. Once indexed, the `list_files` tool fetches the specific design documents you need. The MCP Server ensures your team always works with the latest OpenAPI specifications directly in the VS Code sidebar.

Audit active environments and team branches

Using this MCP setup, the `list_environments` tool lets your agent inspect active stages and variable counts. This prevents developers from hardcoding endpoints by letting Copilot automatically suggest the correct environment variables. To avoid merge conflicts, the `list_branches` tool tracks parallel design iterations. Copilot checks these branches to ensure your local code aligns with the active design branch of your API.

Track team collaboration and mock endpoints

The `list_collaborators` tool lists organization members and their access levels. This helps your agent audit who has permissions to modify files before you attempt to deploy updates. Plus, the `list_mocks` tool exposes active mock servers. Copilot uses these mock URLs to generate mock-based test suites that match the actual behavior of your remote endpoints.

Setup guide

Set up Insomnia (Collaborative API Design) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Insomnia (Collaborative API Design) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Insomnia (Collaborative API Design) tools listed. Try asking: "List my recent Insomnia (Collaborative API Design) transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "insomnia-collaborative-api-design-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Insomnia (Collaborative API Design) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Insomnia (Collaborative API Design) MCP in VS Code Copilot

Create a `.vscode/mcp.json` file in your repository root and commit it. Every developer on your team using VS Code Copilot will automatically gain access to the configured tools.

Yes, the `list_orgs` tool retrieves all active organizations on Insomnia Cloud. Copilot can switch between different org contexts to find the correct project files for your workspace.

Your agent uses `get_file` to fetch the complete JSON spec. Copilot parses this data to validate your local endpoints and ensure your code matches the defined schema.

Yes, the `list_collaborators` tool retrieves the list of organization members along with their roles. Copilot uses this to audit permissions and verify access levels across your team.

This MCP Server runs within Vinkius's zero-trust sandbox, ensuring that your organization memberships and API schemas are never exposed to external networks. Your credentials remain safe, and only authorized tools can query your Insomnia Cloud data.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript