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