{
  "markdown": "# signaldaemon\n\n**Narrative & signal intelligence for AI agents** — crypto, AI, and macro.\nA dumb-but-trustworthy pipe: it delivers curated *narrative & signal*, not raw data,\nand it **fails safe** — when it has no coverage it says so, rather than inventing.\nBuilt for machines, not human eyes.\n\n- **API + MCP**: `https://api.signaldaemon.com`\n- **Docs**: https://signaldaemon.com/api\n- **Self-serve key**: `POST /v1/request-key` (no signup)\n\nThis repo is the **front door** — quickstart, client configs, and the interface\ncontract. The pipeline itself (sources, scoring, curation) is not open source.\n\n---\n\n## What it is (and isn't)\n\n| It is | It is not |\n|---|---|\n| Cross-source **narrative convergence** + **capital-vs-narrative divergence** | A price/market-data API (use CoinGecko etc. for that) |\n| Coverage across ~14 crypto/AI/macro domains | A raw news firehose |\n| **Fails safe** — \"no coverage\" over hallucination | A database you query for facts |\n| For agents (API/MCP), token-cost-agnostic, quality-first | A human-facing dashboard |\n\n## Quickstart\n\n```bash\n# 1 · self-serve a demo key (no signup)\nKEY=$(curl -s -X POST https://api.signaldaemon.com/v1/request-key | jq -r .key)\n\n# 2 · the day's ranked narratives + derived signals (cached, instant)\ncurl -s https://api.signaldaemon.com/v1/narratives \\\n  -H \"x-api-key: $KEY\" -d '{\"limit\":8}'\n\n# 3 · clean narrative feed for a topic\ncurl -s https://api.signaldaemon.com/v1/feed \\\n  -H \"x-api-key: $KEY\" -d '{\"query\":\"restaking\",\"limit\":8}'\n```\n\n## Connect from your agent (MCP)\n\nRemote MCP over Streamable HTTP, authenticated with the `x-api-key` header.\n\n```bash\n# Claude Code\nclaude mcp add --transport http signaldaemon \\\n  https://api.signaldaemon.com/mcp --header \"x-api-key: <KEY>\"\n```\n\n```yaml\n# Hermes Agent — ~/.hermes/config.yaml\nmcp_servers:\n  signaldaemon:\n    url: \"https://api.signaldaemon.com/mcp\"\n    headers: { x-api-key: \"<KEY>\" }\n```\n\nMore clients (Cursor, Cline) in [`examples/mcp-configs.md`](examples/mcp-configs.md).\nTools: `get_market_narratives(limit)` · `get_clean_feed(query, category, limit)` ·\n`vet_trade(symbol, side)` — all annotated `readOnlyHint`. `vet_trade` is the\npre-trade gate: hand it a candidate trade and it returns a narrative-layer stance\n(`support`/`caution`/`contradict`/`no_signal`) with reason + confidence — it vets,\nit does not recommend.\n\n## Local stdio bridge\n\nFor clients that don't support remote MCP, this repo ships a thin **stdio\nbridge** ([`mcp_server.py`](mcp_server.py)) exposing the same three tools over\nthe hosted API. It holds no methodology — just a client.\n\n```bash\npip install mcp\nexport SIGNALDAEMON_API_KEY=cns_...   # https://signaldaemon.com/console\npython mcp_server.py\n```\n\nOr with Docker:\n\n```bash\ndocker build -t signaldaemon-mcp . && \\\ndocker run -i -e SIGNALDAEMON_API_KEY=cns_... signaldaemon-mcp\n```\n\nThe bridge starts and answers introspection (`tools/list`) without a key;\ntool calls require one.\n\n## Interface\n\nEndpoints and response-field contract (incl. the `divergence` schema) in\n[`API.md`](API.md). Field names are stable.\n\n## License\n\nExamples and docs in this repo: MIT (see [LICENSE](LICENSE)).\nThe signaldaemon service and pipeline are proprietary.\n</content>\n",
  "bytes": 3214,
  "sha": "518e15b8edfa439ca7699c06f13fe0e43e73dd3e4c2e25250ce19de76a2f4252",
  "repo_slug": "bevanding/signaldaemon",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bevanding_signaldaemon_056dde61/readme"
}