# Octodamus Market Intelligence

Real-time crypto Oracle signals, Fear & Greed, Polymarket edge plays, BTC trend for AI agents. x402 native, 27 live data feeds.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add octodamusai/market-intelligence

# Browse available tools
npx -y @smithery/cli@latest tool list octodamusai/market-intelligence

# Get full schema for a tool
npx -y @smithery/cli@latest tool get octodamusai/market-intelligence get_agent_signal

# Call a tool
npx -y @smithery/cli@latest tool call octodamusai/market-intelligence get_agent_signal '{}'
```

## Direct MCP Connection

Endpoint: `https://market-intelligence--octodamusai.run.tools`

**Required config:**
- `api_key` (query) — Your OctoData API key. Get free at api.octodamus.com/v1/signup

## Tools (8)

- `get_agent_signal` — Primary signal endpoint. Returns action (BUY/SELL/HOLD), confidence (0-1), signal (BULLISH/BEARISH/NEUTRAL), fear_greed…
- `get_polymarket_edge` — Top Polymarket prediction markets with EV scoring. Returns ranked list with recommended_side, expected value, and confi…
- `get_sentiment` — AI sentiment scores for BTC, ETH, SOL and macro themes. score -1.0 to +1.0. Optionally filter by symbol (BTC, ETH, SOL).
- `get_prices` — Current crypto prices with 24h % change for major assets.
- `get_market_brief` — Full AI market briefing in narrative format — ideal for agent reasoning context.
- `get_all_data` — Combined snapshot: signal + sentiment + prices + Polymarket in one call.
- `get_oracle_signals` — Raw Oracle pack — individual votes from all 11 oracles, consensus strength, win rate.
- `get_data_sources` — List all 27 live data feeds powering Octodamus. No API key required.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get octodamusai/market-intelligence <tool-name>
```