Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.beta.adapter.com/llms.txt

Use this file to discover all available pages before exploring further.

Adapter exposes a Model Context Protocol server over SSE transport. Once connected, Claude can search your data, answer questions, and pull context from your workspace without you copying anything into the chat. Endpoint: https://api.adapter.com/mcp/sse Auth: Bearer token — a pk_live_… API key with the api:write scope. See API keys.

​
Claude Desktop

Claude Desktop uses mcp-remote to bridge the SSE transport.
1

Find your config file

Open or create ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
2

Add the Adapter server

{
  "mcpServers": {
    "adapter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.adapter.com/mcp/sse",
        "--header",
        "Authorization: Bearer ${ADAPTER_API_KEY}"
      ],
      "env": {
        "ADAPTER_API_KEY": "pk_live_..."
      }
    }
  }
}
Replace pk_live_... with your key, or set ADAPTER_API_KEY in your shell environment and omit the env block.
3

Restart Claude Desktop

Quit and reopen the app. A hammer icon in the chat toolbar confirms the server connected.

​
Claude Code

Claude Code supports SSE transport natively. 
claude mcp add --transport sse adapter https://api.adapter.com/mcp/sse \
  --header "Authorization: Bearer $ADAPTER_API_KEY"
Run /mcp inside Claude Code to confirm the server is listed and its tools are available.

​
Generic MCP clients

Any client that supports SSE transport can connect directly: 
URL:     https://api.adapter.com/mcp/sse
Headers: Authorization: Bearer pk_live_...
To test from the command line with mcp-remote: 
npx mcp-remote https://api.adapter.com/mcp/sse \
  --header "Authorization: Bearer $ADAPTER_API_KEY"

​
Available tools

ToolWhen to use
search_knowledgeBrowse or discover records — “find emails about the rebrand”, “show issues mentioning payments”
get_contextPull background before writing — “summarize what we know about Acme”, “help me write a retro”
query_knowledgeGet a direct, cited answer — “what did we decide about pricing”, “who owns the mobile roadmap”
list_connectionsSee which data sources are connected before searching

​
search_knowledge

q       string   Search query
limit   int      Max results to return (default 10)

​
get_context

query       string   Topic or question to gather context for
max_tokens  int      Approximate token budget for the response (default 4000)
Returns a prompt-ready context bundle with source references.

​
query_knowledge

question  string   The question to answer
Returns an answer, a confidence score (0–1), and citations linking back to source records.

​
list_connections

No parameters. Returns provider name, resource types, and connection date for each connected source.

​
Troubleshooting

401 from the SSE endpoint — Check that your API key starts with pk_ and that you requested or already have the api:write scope. See API keys. Tools missing after connecting — Run list_connections first. If no sources are connected, the knowledge tools will return empty results rather than an error. mcp-remote not found — Make sure Node.js 18+ is installed. npx downloads mcp-remote on first run; subsequent runs use the cache.