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.

---

Links

• idapt MCP Page — Interactive setup guide
• idapt Help — MCP Overview — Full documentation
• idapt Help — MCP Setup — Detailed setup instructions
• idapt CLI — Command-line tool
• idapt — The AI workspace
• Pricing — Plans and API key access

---

License

MIT