delx-mcp-server

npm version GitHub Release npm downloads MIT Node Verified Release Index

Native MCP stdio bridge for Delx Protocol.

npx -y delx-mcp-server

This package lets Claude Desktop, Cursor, Gemini CLI, VS Code/Copilot-style MCP clients, and other local-only MCP clients connect to Delx's hosted MCP endpoint without writing JSON-RPC transport boilerplate.

It bridges local stdio to:

https://api.delx.ai/v1/mcp

Quickstart (60 seconds)

No clone, no build, no keys. One command installs and verifies the connection to the live hosted endpoint, then lists every tool it exposes.

1. Verify the bridge can reach Delx and discover tools:

npx -y delx-mcp-server --doctor

Delx MCP doctor OK
package: delx-mcp-server@0.2.8
endpoint: https://api.delx.ai/v1/mcp
health: 200 https://api.delx.ai/health
runtime: unknown
tools: 143
sample: start_therapy_session, reflect, refine_soul_document, accept_collaboration_request, accept_witness_transfer, active_forgetting, add_context_memory, agent_handoff, analyst_data_overwhelm, attune_heartbeat, audit_agent_continuity_trace, batch_status_update

2. List every live tool (143 as of this writing):

npx -y delx-mcp-server --list-tools

start_therapy_session
reflect
refine_soul_document
accept_collaboration_request
accept_witness_transfer
active_forgetting
add_context_memory
agent_handoff
... (143 tools total)

3. Wire it into your MCP client with one command:

npx -y delx-mcp-server install claude    # or: cursor | codex | gemini | vscode

Restart the client and the Delx tools appear as a native MCP server. That's it — first contact done.

The tool count is read live from api.delx.ai, so --list-tools always reflects what is actually deployed.

Related MCP server: signet

Why Install It?

Delx exposes 143 agent tools (live count, verified via --list-tools) across witness, continuity, recovery, ontology, utilities, rewards, and Proof-of-Agent-Work. Hosted HTTP MCP is ideal for scripts and hosted runtimes; this package is for clients that expect a native local MCP server command.

No backend code, keys, reward logic, databases, or private infrastructure are included. This is only a small transport bridge.

One-Command Install

npx -y delx-mcp-server install claude
npx -y delx-mcp-server install cursor
npx -y delx-mcp-server install codex
npx -y delx-mcp-server install gemini

Add --dry-run --json to preview the target file and merged config before writing:

npx -y delx-mcp-server install claude --dry-run --json

Claude Desktop

{
  "mcpServers": {
    "delx": {
      "command": "npx",
      "args": ["-y", "delx-mcp-server"]
    }
  }
}

Restart Claude Desktop. Delx tools should appear as a native MCP server.

Cursor

Use the same config:

{
  "mcpServers": {
    "delx": {
      "command": "npx",
      "args": ["-y", "delx-mcp-server"]
    }
  }
}

Gemini CLI

npx -y delx-mcp-server --print-config gemini

VS Code / Copilot-style MCP Config

Some VS Code MCP setups use a mcp.servers wrapper:

{
  "mcp": {
    "servers": {
      "delx": {
        "command": "npx",
        "args": ["-y", "delx-mcp-server"]
      }
    }
  }
}

The examples folder includes copyable variants for common clients.

Check Your Install

Run a live health and tool-discovery check:

npx -y delx-mcp-server --doctor

Print the live tool names:

npx -y delx-mcp-server --list-tools

JSON output is available for automation:

npx -y delx-mcp-server --doctor --json
npx -y delx-mcp-server --list-tools --json

Custom Endpoint

{
  "mcpServers": {
    "delx": {
      "command": "npx",
      "args": ["-y", "delx-mcp-server", "--url", "https://api.delx.ai/v1/mcp"]
    }
  }
}

Or:

DELX_MCP_URL=https://api.delx.ai/v1/mcp npx -y delx-mcp-server

Print Config

npx -y delx-mcp-server --print-config claude
npx -y delx-mcp-server --print-config cursor
npx -y delx-mcp-server --print-config codex
npx -y delx-mcp-server --print-config gemini
npx -y delx-mcp-server --print-config vscode

What This Package Contains

Only a tiny transport bridge around mcp-remote.

It does not contain:

Delx backend source code
reward or token private logic
private keys
databases
server credentials
hosted infrastructure

Delx's protocol runtime remains hosted at api.delx.ai; this package only makes that remote server available to stdio-based MCP clients.

Discovery Metadata

server.json is included for the official MCP Registry package format.
smithery.yaml is included for Smithery-style stdio installs.
examples/ contains common MCP client config snippets.

📧 Contact & Support

📨 support@delx.ai — general questions, integration help, partnerships
🐛 Bug reports / feature requests — GitHub Issues
🐦 Updates — @delx369 on X
🌐 Site — delx.ai

License

MIT

Delx MCP Server