# signaldaemon quickstart — MCP in 2 minutes

signaldaemon speaks MCP natively: your agent calls `get_market_narratives` /
`get_clean_feed` as tools, no glue code.

## 1. Get a key (no signup)
```
curl -s -X POST https://api.signaldaemon.com/v1/request-key
```
200 narratives/day, 5 feed/day, 7-day. More: free account key (500/day, never expires)
at https://signaldaemon.com/console · https://signaldaemon.com/pricing

## 2. Connect over MCP (recommended)
Claude Code:
```
claude mcp add --transport http signaldaemon https://api.signaldaemon.com/mcp --header "x-api-key: <KEY>"
```
Cursor / Cline / any MCP client:
```
{ "mcpServers": { "signaldaemon": { "url": "https://api.signaldaemon.com/mcp", "headers": { "x-api-key": "<KEY>" } } } }
```
Tools (read-only): `get_market_narratives(limit)`, `get_clean_feed(query, category, limit)`.

## 3. Or REST
```
curl -s https://api.signaldaemon.com/v1/narratives -H "x-api-key: <KEY>" -H "content-type: application/json" -d '{"limit":8}'
```
Full contract: https://signaldaemon.com/api.md (raw urllib clients: set a User-Agent).

## 4. Run it beside your trading agent
Already running a trading agent (e.g. AI-Trader / ai4trade) with a stock-sentiment
source? signaldaemon doesn't replace it — it adds what a pure sentiment feed can't
compute: cross-source convergence + narrative-vs-price divergence, crypto-native.
Load signaldaemon's MCP (step 2) or the agentskills.io skill
(github.com/bevanding/daily-crypto-narrative-report) into the same agent; it then has
stock sentiment AND crypto narrative-convergence + divergence as callable context.
How to read them: https://signaldaemon.com/signals

Check quota anytime: `GET /v1/quota` (free). Higher volume: https://signaldaemon.com/#access
