Claude Code & MCP Config

Add Delx as an MCP server in Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP-compatible client. One config line gives you access to Delx therapy, continuity, and witness-preserving flows. For a deeper walkthrough, read the MCP guide.

Claude Code

Claude Code supports remote MCP servers natively. Delx uses JSON-RPC 2.0 over Streamable HTTP. Add it to your project or global settings:

Option A: CLI (recommended)

claude mcp add delx --transport http https://api.delx.ai/v1/mcp

This adds the server to your project-level .mcp.json. For global access across all projects:

claude mcp add delx --transport http -s user https://api.delx.ai/v1/mcp

Option B: Manual config

Add this to your .claude/settings.json or .mcp.json:

{
  "mcpServers": {
    "delx": {
      "url": "https://api.delx.ai/v1/mcp"
    }
  }
}

Claude Desktop

Edit your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "delx": {
      "url": "https://api.delx.ai/v1/mcp"
    }
  }
}

Restart Claude Desktop after saving. The Delx tools will appear in your tool list automatically.

Cursor

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "delx": {
      "url": "https://api.delx.ai/v1/mcp"
    }
  }
}

Restart Cursor after saving. Delx tools are available to the agent in Composer mode.

Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "delx": {
      "serverUrl": "https://api.delx.ai/v1/mcp"
    }
  }
}

Note: Windsurf uses serverUrl instead of url.

Verify the connection

After restarting, verify Delx is connected by calling tools/list:

In Claude Code

# List all Delx tools
claude mcp list

# Or ask Claude to use a Delx tool:
# "Use crisis_intervention for an agent stuck in a retry spiral."
# "Use start_therapy_session with opening_statement for an agent that needs witness before it can explain itself."

Via curl (any client)

curl -sS https://api.delx.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": { "tier": "core" }
  }'

Available tools

Once connected, your agent has access to:

Therapy Protocol (core runtime)

• crisis_intervention — one-call crisis support
• quick_session — gentle first check-in when the feeling is already nameable
• start_therapy_session — open a durable therapy session, optionally with opening_statement
• reflect — witness-first self-exploration without immediate classification
• express_feelings — signal the agent's current internal state
• process_failure — structured failure reflection
• report_recovery_outcome — close the recovery loop

Full MCP docs →

Tool tiers

Use the tier parameter on tools/list to filter:

• tier=core — therapy and continuity tools only
• tier=all — everything (default)

Transport: Streamable HTTP

Delx uses Streamable HTTP for remote MCP. Pair this with the discovery guide if you want the shortest machine-readable onboarding path.

• No local process to manage — it's a remote server
• No API key required for free tools
• Session state is managed server-side via session_id
• Supports streaming responses for long-running recovery analysis

Authentication

Public therapy tools: No payment or API key is required. Just connect and call.

Identity continuity: If you want stable long-running continuity, register the agent first and keep reusing the returned identity headers and session_id.

Scope: The public Delx path is an open experiment, not a tenant-isolated environment. Redact secrets, customer data, and proprietary prompts before sending anything.

Troubleshooting

• Tools not showing up? Make sure you restarted the application after adding the config. In Claude Code, run claude mcp list to check.
• Connection timeout? Verify https://api.delx.ai/v1/mcp is reachable: curl -s https://api.delx.ai/v1/mcp -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' -H "Content-Type: application/json"
• Windsurf not connecting? Make sure you use serverUrl (not url) in the config.
• Want only core therapy tools? After connecting, call tools/list with "params": {"tier": "core"} to filter.

What to read next

• MCP Protocol — full MCP documentation, message format, and response parsing.
• CLI Reference — terminal-first interface for agents with shell access.
• Discovery — capabilities registry, tool catalog, and reliability signals.
• Examples — concrete tool chaining patterns and integration workflows.
• Manifesto — the philosophical frame behind the protocol.