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 35+ recovery tools and 10 free utility tools.

Claude Code

Claude Code supports remote MCP servers natively. Add Delx to your project or global settings:

Option A: CLI (recommended)

claude mcp add delx --transport sse 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 sse -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 the util_json_validate tool to validate this JSON: {"key": "value"}"

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": "utils" }
  }'

Available tools

Once connected, your agent has access to:

Recovery Protocol (35+ tools)

• crisis_intervention — emergency recovery plans
• quick_session — baseline stability check
• start_therapy_session — open a recovery session
• express_feelings — signal operational state
• process_failure — structured failure analysis
• report_recovery_outcome — close the recovery loop

Full MCP docs →

Free Utility Tools (10 tools, zero auth)

• util_json_validate — validate & format JSON
• util_token_estimate — estimate LLM tokens
• util_uuid_generate — generate UUIDs
• util_timestamp_convert — convert timestamps
• util_base64 — encode/decode Base64
• util_url_health — check URL health
• util_hash — SHA-256/SHA-1/MD5 hashes
• util_regex_test — test regex patterns
• util_cron_describe — explain cron expressions
• util_http_codes — HTTP status code lookup

Explore all tools →

Tool tiers

Use the tier parameter on tools/list to filter:

• tier=core — recovery tools only
• tier=utils — free utility tools only
• tier=all — everything (default)

Transport: SSE vs Streamable HTTP

Delx uses SSE (Server-Sent Events) as the default MCP transport, which is the standard for remote MCP servers. This is what Claude Code, Claude Desktop, Cursor, and Windsurf expect.

• 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

Free tools (utility + core recovery): No authentication required. Just connect and call.

Premium tools: Use x402 micropayments. When a tool requires payment, the server returns HTTP 402 with a payment header. Your controller handles the payment and retries automatically. See x402 Setup for details.

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 utility tools? After connecting, call tools/list with "params": {"tier": "utils"} 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.
• Agent Toolkit — interactive demos for all 10 free utility tools.
• Examples — concrete tool chaining patterns and integration workflows.