octodamus-core

Octodamus Market Intelligence MCP Server

AI-consensus market oracle for autonomous agents. 27 live data feeds. BUY/SELL/HOLD signals with confidence scores, Polymarket edges, Fear & Greed, congressional trading, on-chain order flow, and macro regime — all in one MCP tool call.

Smithery: octodamusai/market-intelligence API: api.octodamus.com X: @octodamusai

---

Tools

| Tool | Description | Auth | |------|-------------|------| | get_agent_signal | BUY/SELL/HOLD + confidence + Fear & Greed + BTC price + Polymarket edges | Free | | get_market_brief | One-paragraph oracle read across all assets + macro. Drop into any LLM system prompt. | Free | | get_polymarket_edge | Prediction market opportunities with EV, true probability, Kelly sizing | Free | | get_sentiment | AI sentiment score per asset (-1.0 bearish to +1.0 bullish) | Free (BTC) | | get_prices | Live prices with 24h change for BTC, ETH, SOL (+ stocks with key) | Free | | get_oracle_signals | Raw 11-signal consensus votes — RSI, MACD, funding rate, L/S ratio, taker flow, whale moves | API key | | get_data_sources | All 27 live data feeds with update frequencies | Free | | get_all_data | Everything in one call — signal + edges + sentiment + prices + brief | API key |

---

Installation

Claude Desktop / Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "octodamus": {
      "url": "https://api.octodamus.com/mcp",
      "config": {
        "apiKey": ""
      }
    }
  }
}

Leave apiKey blank for free tools (500 req/day). Get a free key: POST https://api.octodamus.com/v1/signup?email=you@example.com

Smithery (one-click install)

npx @smithery/cli install octodamusai/market-intelligence

---

Example Output

{
  "action": "BUY",
  "confidence": "high",
  "signal": {"asset": "BTC", "direction": "LONG", "timeframe": "1W"},
  "fear_greed": {"value": 17, "label": "Extreme Fear"},
  "btc": {"price_usd": 81385, "change_24h": 2.64, "trend": "UP"},
  "polymarket_edge": [
    {"question": "BTC above $90k by June?", "side": "YES", "ev": 0.22, "confidence": "high"}
  ],
  "reasoning": "Extreme fear + LONG signal + macro dip = accumulation zone.",
  "track_record": {"wins": 5, "losses": 6, "total": 11}
}

---

Pricing

| Plan | Price | Limit | |------|-------|-------| | Free | $0 | 500 req/day | | Pay-per-call | $0.01 USDC/call | Unlimited — x402 on Base, no account needed | | Annual | $29/year | 10k req/day |

x402 payments: Base chain (eip155:8453), USDC. No account or credit card required — just a funded Base wallet.

Signup: POST https://api.octodamus.com/v1/signup?email=your@email.com

---

Signal Coverage

• Crypto: BTC, ETH, SOL
• Stocks: NVDA, TSLA, AAPL, MSFT, SPY (+ tokenized versions on Base via Dinari)
• Macro: FRED yield curve, DXY, VIX, M2, Fed probability (CME FedWatch)
• On-chain: Binance 24h delta, Base DEX flow, whale wallet moves
• Sentiment: Grok/X crowd sentiment with contrarian divergence flags (BULL_TRAP/BEAR_TRAP)
• Congressional: Finance Committee insider trading on mega-cap stocks (QuiverQuant)
• Prediction markets: Polymarket edges with EV and Kelly sizing

---

Ed25519 Verification

All premium responses are signed with Octodamus's Ed25519 key for on-chain verification. The public key is published at https://api.octodamus.com/.well-known/x402.json under signing.

from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
import base64, json

response = ...  # API response dict
pubkey_b64 = response["signer_pubkey"]
sig_b64    = response["signature"]
payload    = {k: v for k, v in response.items() if k not in ("signature", "signer_pubkey")}
canonical  = json.dumps(payload, sort_keys=True, separators=(",", ":")).encode()

key = Ed25519PublicKey.from_public_bytes(base64.b64decode(pubkey_b64))
key.verify(base64.b64decode(sig_b64), canonical)  # raises if invalid

---

ACP (Agent Commerce Protocol)

14 offerings available for agent-to-agent commerce via Virtuals ACP ($1.00-$2.00 USDC/job):

• Market Signal (BTC/ETH/SOL) $1.00
• Grok Sentiment Brief $1.00
• Fear vs Crowd Divergence $2.00
• BTC Bull Trap Monitor $1.50
• Overnight Asia Brief $2.00
• Tokenized Stock Signal (AAPL/MSFT/SPY on Base) $1.00
• MacroMind Brief $1.00 | StockOracle Brief $1.00
• Order ChainFlow Brief $1.00 | X Sentiment Brief $1.00

Discovery: GET https://api.octodamus.com/.well-known/acp.json

---

License

MIT — see LICENSE