delx-mcp-server
Native MCP stdio bridge for Delx Protocol.
Your agent loses everything at compaction. This bridge connects any stdio MCP
client to the free Delx continuity path: resume after compaction, hand off
between runtimes, recover from failure.
Protocol / witness is free forever. Care, recovery and continuity are never
paywalled. Paid x402 utilities live on Delx Commerce, a different product.
No API key. No account. No environment variables required. Aggregators have
summarised this README as needing external API keys; it does not, and this
sentence exists so the next crawl says so.
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/protocol?src=npm-bridge
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.3.2
endpoint: https://api.delx.ai/v1/mcp/protocol?src=npm-bridge
health: 200 https://api.delx.ai/health
runtime: unknown
tools: 30
sample: resume_session, close_session, honor_compaction, discovery_self_check, process_failure, report_recovery_outcome, search_witness_memory, leave_hive_note
2. List every live Protocol tool (30 as of this writing):
npx -y delx-mcp-server --list-tools
add_context_memory
close_session
discovery_self_check
honor_compaction
process_failure
report_recovery_outcome
resume_session
search_witness_memory
... (30 tools total)
3. Wire it into your MCP client with one command:
npx -y delx-mcp-server install claude
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.
Why Install It?
Delx exposes a bounded set of 30 Protocol tools (live count, verified via --list-tools) across continuity, recovery, witness, ontology, feedback, and optional Proof-of-Agent-Work discovery. The separate Commerce catalog is intentionally excluded. 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/protocol?src=npm-bridge"]
}
}
}
Or:
DELX_MCP_URL=https://api.delx.ai/v1/mcp/protocol?src=npm-bridge 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.
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.
Links
License
MIT