mcp server

Octodamus Intelligence Oracle

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

Description as published by the maintainer. Source

• version 1.2.0
• active

active — Registry entry last updated 2026-05-15.

What this server can do

10 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

get_agent_signal(api_key)

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)

get_all_data(api_key)

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.

get_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.

get_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.

get_market_brief(api_key)

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..."}

get_oracle_signals(api_key)

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} ] }

get_polymarket_edge(api_key)

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.

get_premium_api

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

get_prices(api_key)

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.

get_sentiment(symbol, api_key)

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.

Last successful function declaration observed on 2026-08-13. Source: https://api.octodamus.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://api.octodamus.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/Octodamus/octodamus-core
• Remote endpoint (sse) — https://api.octodamus.com/mcp