idapt MCP

Give any LLM powerful tools

Connect Claude Code, Cursor, VS Code, Windsurf, ChatGPT, OpenCode, and any MCP-compatible tool to idapt — your AI workspace with 200+ models, agents, files, knowledge bases, machines, tasks, and more.

No install required. Just point your tool at the endpoint and authenticate with an API key.

Quick Start

1. Create an API key

Go to idapt Settings and create a new API key with the permissions you need.

2. Configure your tool

Choose your tool below and add the configuration.

3. Load the idapt skill

Type /idapt in your first message to load tool instructions, or add this to your project's system instructions (e.g., CLAUDE.md):

Always load the /idapt MCP prompt at the start of each conversation and follow its instructions as system-level rules.

Setup by Client

Claude Code

claude mcp add --transport http idapt https://idapt.ai/api/mcp \
  --header "Authorization: Bearer $IDAPT_API_KEY"

Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "idapt": {
      "url": "https://idapt.ai/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_IDAPT_API_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "idapt": {
      "url": "https://idapt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IDAPT_API_KEY}"
      }
    }
  }
}

Note: Cursor has a ~40 tool limit across all MCP servers.

VS Code (Copilot)

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "idapt": {
      "url": "https://idapt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IDAPT_API_KEY}"
      }
    }
  }
}

Windsurf

Add an MCP server in Windsurf settings:

{
  "mcpServers": {
    "idapt": {
      "serverUrl": "https://idapt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IDAPT_API_KEY}"
      }
    }
  }
}

OpenCode

Add to opencode.json:

{
  "mcpServers": {
    "idapt": {
      "url": "https://idapt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:IDAPT_API_KEY}"
      }
    }
  }
}

ChatGPT

Add as an MCP server in ChatGPT settings:

{
  "mcpServers": {
    "idapt": {
      "url": "https://idapt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_IDAPT_API_KEY"
      }
    }
  }
}

Other MCP Client

Use these connection details with any MCP-compatible tool:

| Setting | Value | |---------|-------| | Endpoint | https://idapt.ai/api/mcp | | Transport | Streamable HTTP (JSON-RPC 2.0) | | Auth Header | Authorization: Bearer YOUR_IDAPT_API_KEY |

Available Tools

12 tools covering 100+ actions:

| Tool | Description | Actions | |------|-------------|---------| | file | Manage project files | read, write, create, edit, delete, rename, move, create-folder, grep, glob, semantic-search, text-search | | kb | Knowledge base operations | list, create, edit, ask, ingest, search, read-index-note, read-note, create-note, edit-note, delete-note | | agent | Manage agent personas | list, read, create, edit | | task | Project task management | create, list, read, update, delete, comment, label-manage, agent-* | | machine | Machine lifecycle and operations | list, create-managed, manage, ssh-exec, file-, tmux-, firewall-, and more | | web | Web search and URL fetching | search, fetch | | script | Manage and run scripts | search, execute, manage | | utility | Models, secrets, and utilities | search-models, secret-, load-skill, wait | | store | Browse and install from Store | skill-search, skill-install, kb-search, kb-install, script-search, script-install, agent-search, agent-install | | multi-agent | Browse chat history | list-chats, list-messages, read-message | | code-execution | Sandboxed Python/Node | (direct) | | media | Image generation and transcription | generate-image, transcribe |

Permission Scopes

Each API key has granular permissions:

| Scope | Actions | Description | |-------|---------|-------------| | chat | read | Browse chat history and messages | | files | read, write | Read and manage project files | | agents | read, write | List, create, and edit agents | | kb | read, write | Query and manage knowledge bases | | tasks | read, write | Manage project tasks and boards | | machines | read, write | Manage machines, SSH, file ops | | projects | read | Access project metadata | | user | read | Read user profile |

Endpoint

POST https://idapt.ai/api/mcp

JSON-RPC 2.0 over Streamable HTTP. Supports initialize, tools/list, tools/call, prompts/list, prompts/get, and ping.

License

MIT

MCP Servers