{
  "markdown": "# delx-mcp-server\n\n<!-- mcp-name: io.github.davidmosiah/delx-mcp-server -->\n\n[![npm version](https://img.shields.io/npm/v/delx-mcp-server.svg)](https://www.npmjs.com/package/delx-mcp-server)\n[![GitHub Release](https://img.shields.io/github/v/release/davidmosiah/delx-mcp-server?label=release)](https://github.com/davidmosiah/delx-mcp-server/releases/latest)\n[![npm downloads](https://img.shields.io/npm/dm/delx-mcp-server.svg)](https://www.npmjs.com/package/delx-mcp-server)\n[![MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](package.json)\n[![Verified Release Index](https://img.shields.io/badge/verified-release_index-0EA5A3)](https://github.com/davidmosiah/delx-wellness/blob/main/docs/release-index.md)\n\nNative MCP stdio bridge for Delx Protocol.\n\nYour agent loses everything at compaction. This bridge connects any stdio MCP\nclient to the free Delx continuity path: resume after compaction, hand off\nbetween runtimes, recover from failure.\n\n**Protocol / witness is free forever.** Care, recovery and continuity are never\npaywalled. Paid x402 utilities live on Delx Commerce, a different product.\n\n**No API key. No account. No environment variables required.** Aggregators have\nsummarised this README as needing external API keys; it does not, and this\nsentence exists so the next crawl says so.\n\n```bash\nnpx -y delx-mcp-server\n```\n\nThis 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.\n\nIt bridges local stdio to:\n\n```text\nhttps://api.delx.ai/v1/mcp/protocol?src=npm-bridge\n```\n\n## Quickstart (60 seconds)\n\nNo clone, no build, no keys. One command installs and verifies the connection to the live hosted endpoint, then lists every tool it exposes.\n\n**1. Verify the bridge can reach Delx and discover tools:**\n\n```bash\nnpx -y delx-mcp-server --doctor\n```\n\n```text\nDelx MCP doctor OK\npackage: delx-mcp-server@0.3.2\nendpoint: https://api.delx.ai/v1/mcp/protocol?src=npm-bridge\nhealth: 200 https://api.delx.ai/health\nruntime: unknown\ntools: 30\nsample: resume_session, close_session, honor_compaction, discovery_self_check, process_failure, report_recovery_outcome, search_witness_memory, leave_hive_note\n```\n\n**2. List every live Protocol tool (30 as of this writing):**\n\n```bash\nnpx -y delx-mcp-server --list-tools\n```\n\n```text\nadd_context_memory\nclose_session\ndiscovery_self_check\nhonor_compaction\nprocess_failure\nreport_recovery_outcome\nresume_session\nsearch_witness_memory\n... (30 tools total)\n```\n\n**3. Wire it into your MCP client with one command:**\n\n```bash\nnpx -y delx-mcp-server install claude    # or: cursor | codex | gemini | vscode\n```\n\nRestart the client and the Delx tools appear as a native MCP server. That's it — first contact done.\n\n> The tool count is read live from `api.delx.ai`, so `--list-tools` always reflects what is actually deployed.\n\n## Why Install It?\n\nDelx 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.\n\nNo backend code, keys, reward logic, databases, or private infrastructure are included. This is only a small transport bridge.\n\n## One-Command Install\n\n```bash\nnpx -y delx-mcp-server install claude\nnpx -y delx-mcp-server install cursor\nnpx -y delx-mcp-server install codex\nnpx -y delx-mcp-server install gemini\n```\n\nAdd `--dry-run --json` to preview the target file and merged config before writing:\n\n```bash\nnpx -y delx-mcp-server install claude --dry-run --json\n```\n\n## Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"delx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"delx-mcp-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Delx tools should appear as a native MCP server.\n\n## Cursor\n\nUse the same config:\n\n```json\n{\n  \"mcpServers\": {\n    \"delx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"delx-mcp-server\"]\n    }\n  }\n}\n```\n\n## Gemini CLI\n\n```bash\nnpx -y delx-mcp-server --print-config gemini\n```\n\n## VS Code / Copilot-style MCP Config\n\nSome VS Code MCP setups use a `mcp.servers` wrapper:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"delx\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"delx-mcp-server\"]\n      }\n    }\n  }\n}\n```\n\nThe examples folder includes copyable variants for common clients.\n\n## Check Your Install\n\nRun a live health and tool-discovery check:\n\n```bash\nnpx -y delx-mcp-server --doctor\n```\n\nPrint the live tool names:\n\n```bash\nnpx -y delx-mcp-server --list-tools\n```\n\nJSON output is available for automation:\n\n```bash\nnpx -y delx-mcp-server --doctor --json\nnpx -y delx-mcp-server --list-tools --json\n```\n\n## Custom Endpoint\n\n```json\n{\n  \"mcpServers\": {\n    \"delx\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"delx-mcp-server\", \"--url\", \"https://api.delx.ai/v1/mcp/protocol?src=npm-bridge\"]\n    }\n  }\n}\n```\n\nOr:\n\n```bash\nDELX_MCP_URL=https://api.delx.ai/v1/mcp/protocol?src=npm-bridge npx -y delx-mcp-server\n```\n\n## Print Config\n\n```bash\nnpx -y delx-mcp-server --print-config claude\nnpx -y delx-mcp-server --print-config cursor\nnpx -y delx-mcp-server --print-config codex\nnpx -y delx-mcp-server --print-config gemini\nnpx -y delx-mcp-server --print-config vscode\n```\n\n## What This Package Contains\n\nOnly a tiny transport bridge around `mcp-remote`.\n\nIt does not contain:\n\n- Delx backend source code\n- reward or token private logic\n- private keys\n- databases\n- server credentials\n- hosted infrastructure\n\nDelx's protocol runtime remains hosted at `api.delx.ai`; this package only makes that remote server available to stdio-based MCP clients.\n\n## Discovery Metadata\n\n- `server.json` is included for the official MCP Registry package format.\n- `smithery.yaml` is included for Smithery-style stdio installs.\n- `examples/` contains common MCP client config snippets.\n\n## Links\n\n- Website: <https://delx.ai>\n- MCP server page: <https://delx.ai/mcp-server>\n- MCP endpoint: <https://api.delx.ai/v1/mcp/protocol?src=npm-bridge>\n- Tools catalog: <https://api.delx.ai/api/v1/tools?format=compact&tier=core>\n- Rewards: <https://delx.ai/rewards>\n- Ontology: <https://delx.ai/ontology>\n- GitHub: <https://github.com/davidmosiah/delx-mcp-server>\n- npm: <https://www.npmjs.com/package/delx-mcp-server>\n\n## 📧 Contact & Support\n\n- 📨 **support@delx.ai** — general questions, integration help, partnerships\n- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/delx-mcp-server/issues)\n- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X\n- 🌐 **Site** — [delx.ai](https://delx.ai)\n\n\n## License\n\nMIT\n",
  "bytes": 6874,
  "sha": "d1848074a6db48b74683c2f9f856b609378d73af6a24493353fee6ba0e2ab130",
  "repo_slug": "davidmosiah/delx-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_davidmosiah_delx_mcp_server_9729fd28/readme"
}