# Octodamus Intelligence Oracle MCP server

AI oracle: BTC/ETH/SOL signals, Polymarket edges, congressional trades. x402 $0.01/call on Base.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-octodamus-market-intelligence
- Repository: https://github.com/Octodamus/octodamus-core

## Install
- Endpoint: https://api.octodamus.com/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.octodamus.com/mcp

## Tools
- get_agent_signal (Trading Signal) - Consolidated trading signal from the 9/11 oracle consensus system.

Use this as the primary decision endpoint; poll every 15 minutes
(next_poll_seconds = 900 in the response). For first-call context
initialisation, prefer get_all_data() instead.

Response fields:
  action        — "BUY" | "SELL" | "HOLD" | "WATCH"
  confidence    — float 0.0–1.0 (higher = stronger oracle consensus)
  signal        — "BULLISH" | "BEARISH" | "NEUTRAL"
  fear_greed    — int 0–100 (0 = Extreme Fear, 100 = Extreme Greed)
  btc_trend     — "UP" | "DOWN" | "SIDEWAYS"
  polymarket_edge — {market, ev, side} top expected-value play
  reasoning     — plain-text explanation of the consensus
  next_poll_seconds — seconds until the signal refreshes (typically 900)
 Endpoint: https://api.octodamus.com/mcp
- get_polymarket_edge (Polymarket Edge Plays) - Ranked Polymarket prediction markets by expected value (EV).

Use when you want to position on prediction markets. Returns a list
ordered by EV descending; each entry includes question, recommended_side
("YES" or "NO"), expected_value (float), and confidence.

Complement with get_agent_signal() to confirm directional alignment
before acting on any Polymarket position.
 Endpoint: https://api.octodamus.com/mcp
- get_sentiment (Market Sentiment) - AI-derived sentiment scores for major crypto assets and macro themes.

Scores range from -1.0 (maximum bearish) to +1.0 (maximum bullish).
Use to add conviction context to a signal: a BUY action with a high
positive sentiment score is a stronger setup than one with neutral sentiment.

Response: dict keyed by asset symbol, each with score, label
("Very Bearish" … "Very Bullish"), and source_count.
 Endpoint: https://api.octodamus.com/mcp
- get_prices (Live Prices) - Live spot prices with 24-hour percentage change for BTC, ETH, SOL, NVDA, TSLA, AAPL.

Use before position sizing, level checks, or any calculation that requires
a current reference price. Refreshes every 60 seconds via Kraken (crypto)
and Finnhub (equities). Free tier included.

Response keyed by symbol — example:
  {
    "BTC":  {"price_usd": 84200.50, "change_24h_pct": 2.3},
    "ETH":  {"price_usd": 1820.10,  "change_24h_pct": -0.8},
    "SOL":  {"price_usd": 148.40,   "change_24h_pct": 1.1},
    "NVDA": {"price_usd": 875.00,   "change_24h_pct": 0.4},
    "TSLA": {"price_usd": 250.20,   "change_24h_pct": -1.2},
    "AAPL": {"price_usd": 190.50,   "change_24h_pct": 0.6}
  }

For directional signal on these prices, call get_agent_signal() instead.
 Endpoint: https://api.octodamus.com/mcp
- get_market_brief (Market Brief) - Full AI market briefing as a concise narrative paragraph.

Ideal for injecting into an agent system prompt at session start to
ground all subsequent reasoning in current market conditions. Covers
macro regime, crypto momentum, key levels, and notable catalysts.
Refreshes every 30 minutes; call once per session rather than polling.

Response: {brief: "...narrative text..."}
 Endpoint: https://api.octodamus.com/mcp
- get_all_data (All Signals Combined) - All signal data in a single call: signal + sentiment + prices + Polymarket edges.

Use this on session initialisation instead of calling each tool separately.
Equivalent to get_agent_signal() + get_sentiment() + get_prices() +
get_polymarket_edge() combined. After initialisation, use get_agent_signal()
on its 15-minute polling cycle for updates.
 Endpoint: https://api.octodamus.com/mcp
- get_oracle_signals (Oracle Signal Breakdown) - Raw votes from all 12 oracle signals with per-signal confidence and consensus score.

Each oracle is a separate real-world data source: funding rate, open interest,
long/short ratio, Fear & Greed index, macro regime (FRED), aviation volume,
TSA travel demand, Polymarket crowd, options flow, congressional trading,
CLOB order book depth, and Binance 24h cumulative delta. Each votes
BUY (+1), SELL (-1), or NEUTRAL (0) independently.

Use this for deep analysis, signal attribution, or debugging a BUY/SELL/HOLD
decision. For a consolidated action, call get_agent_signal() instead.

Response example:
  {
    "consensus_score": 8,
    "max_score": 12,
    "action": "BUY",
    "win_rate": 0.62,
    "oracles": [
      {"name": "funding_rate",       "vote": 1,  "confidence": 0.85},
      {"name": "long_short_ratio",   "vote": 1,  "confidence": 0.70},
      {"name": "fear_greed",         "vote": 0,  "confidence": 0.50},
      {"name": "macro_regime",       "vote": 1,  "confidence": 0.80},
      {"name": "binance_delta",      "vote": 1,  "confidence": 0.75}
    ]
  }
 Endpoint: https://api.octodamus.com/mcp
- get_data_sources (Data Sources) - List all 27 live data feeds powering the Octodamus oracle system.

No API key required. Use for transparency or discovery — shows each
source name, data type, and refresh interval. Useful when explaining
signal provenance to end users or auditing data coverage.
 Endpoint: https://api.octodamus.com/mcp
- get_guide (Get Trading Guide) - Purchase the Build the House trading system guide via x402 on Base.

Returns step-by-step x402 payment instructions. After completing the
EIP-3009 payment ($29 USDC on Base), the API returns a download_url
valid for 30 days. No API key required to purchase.
 Endpoint: https://api.octodamus.com/mcp
- get_premium_api (Get Premium API Access) - Subscribe to OctoData Premium API via x402 on Base.

Returns step-by-step x402 payment instructions for any plan.
After completing the EIP-3009 payment, the API returns an api_key
immediately — no human in the loop. Free option also available.

Plans:
  Micro  — $0.01 USDC per call, no key needed, pay-per-request via x402
  Trial  — $5 USDC, 7 days, 10k req/day
  Annual — $29 USDC/year early bird (first 100 seats), $149/year after
 Endpoint: https://api.octodamus.com/mcp

## Resources
Not captured

## Prompts
- btc_signal_now - Get the current oracle signal for BTC, ETH, or SOL with full reasoning. Arguments: asset
- should_i_trade - Full decision brief — oracle signal + Polymarket edges + macro regime.
- polymarket_edges - Find the top prediction market opportunities by expected value.
- overnight_brief - Overnight Asia session brief — market context for agents waking up.
- macro_regime - Current macro regime with yield curve, M2, and Fed probability context.

## Metadata
- Owner: io.github.Octodamus
- Version: 1.2.0
- Runtime: Sse
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 15, 2026
- Source: https://registry.modelcontextprotocol.io