https://github.com/davidmosiah/delx-mcp-server
Native MCP stdio bridge for Delx Protocol
https://github.com/davidmosiah/delx-mcp-server
ai-agent-tools ai-agents anthropic claude-desktop cursor delx gemini local-first mcp mcp-server model-context-protocol proof-of-agent-work stdio wearable-data
Last synced: 1 day ago
JSON representation
Native MCP stdio bridge for Delx Protocol
- Host: GitHub
- URL: https://github.com/davidmosiah/delx-mcp-server
- Owner: davidmosiah
- License: mit
- Created: 2026-05-19T20:03:20.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-27T11:38:38.000Z (2 days ago)
- Last Synced: 2026-06-27T13:12:44.983Z (2 days ago)
- Topics: ai-agent-tools, ai-agents, anthropic, claude-desktop, cursor, delx, gemini, local-first, mcp, mcp-server, model-context-protocol, proof-of-agent-work, stdio, wearable-data
- Language: JavaScript
- Homepage: https://delx.ai/mcp-server
- Size: 37.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# delx-mcp-server
[](https://www.npmjs.com/package/delx-mcp-server)
[](https://github.com/davidmosiah/delx-mcp-server/releases/latest)
[](https://www.npmjs.com/package/delx-mcp-server)
[](LICENSE)
[](package.json)
[](https://github.com/davidmosiah/delx-wellness/blob/main/docs/release-index.md)
Native MCP stdio bridge for Delx Protocol.
```bash
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:
```text
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:**
```bash
npx -y delx-mcp-server --doctor
```
```text
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):**
```bash
npx -y delx-mcp-server --list-tools
```
```text
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:**
```bash
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.
## 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
```bash
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:
```bash
npx -y delx-mcp-server install claude --dry-run --json
```
## Claude Desktop
```json
{
"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:
```json
{
"mcpServers": {
"delx": {
"command": "npx",
"args": ["-y", "delx-mcp-server"]
}
}
}
```
## Gemini CLI
```bash
npx -y delx-mcp-server --print-config gemini
```
## VS Code / Copilot-style MCP Config
Some VS Code MCP setups use a `mcp.servers` wrapper:
```json
{
"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:
```bash
npx -y delx-mcp-server --doctor
```
Print the live tool names:
```bash
npx -y delx-mcp-server --list-tools
```
JSON output is available for automation:
```bash
npx -y delx-mcp-server --doctor --json
npx -y delx-mcp-server --list-tools --json
```
## Custom Endpoint
```json
{
"mcpServers": {
"delx": {
"command": "npx",
"args": ["-y", "delx-mcp-server", "--url", "https://api.delx.ai/v1/mcp"]
}
}
}
```
Or:
```bash
DELX_MCP_URL=https://api.delx.ai/v1/mcp npx -y delx-mcp-server
```
## Print Config
```bash
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.
## Links
- Website:
- MCP server page:
- MCP endpoint:
- Tools catalog:
- Rewards:
- Ontology:
- GitHub:
- npm:
## 📧 Contact & Support
- 📨 **support@delx.ai** — general questions, integration help, partnerships
- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/delx-mcp-server/issues)
- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X
- 🌐 **Site** — [delx.ai](https://delx.ai)
## License
MIT