Octodamus Intelligence Oracle

Name: Octodamus Intelligence Oracle
Author: Octodamus

Octodamus/octodamus-core

1 repo stars
Updated July 21, 2026
Octodamus/octodamus-core

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

About

AI oracle: BTC/ETH/SOL signals, Polymarket edges, congressional trades. x402 $0.01/call on Base. Add to your MCP config: { Exposes 10 MCP tools including io.github.Octodamus/market-intelligence, | Tool | Description | Auth |, |------|-------------|------|, | `get_data_sources` | All 27 live data feeds with update frequencies | Free |. Install via Claude Desktop, Cursor, or any MCP-compatible client using the upstream server manifest.

**Smithery:** [octodamusai/market-intelligence](https://smithery.ai/server/octodamusai/market-intelligence)
**API:** [api.octodamus.com](https://api.octodamus.com)
**X:** [@octodamusai](https://x.com/octodamusai)
**Stocks:** NVDA, TSLA, AAPL, MSFT, SPY (+ tokenized versions on Base via Dinari)
**Macro:** FRED yield curve, DXY, VIX, M2, Fed probability (CME FedWatch)

Octodamus Intelligence Oracle by the numbers

Exposes 10 verified tools (MCP introspection)
Data as of Jul 22, 2026 (Skillselion catalog sync)

terminal

claude mcp add --transport sse market-intelligence https://api.octodamus.com/mcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.Octodamus/market-intelligence.svg)](https://skillselion.com/mcp/tool/io.github.Octodamus/market-intelligence)

repo stars	★ 1
Transport	SSE
Auth	None
Tools	10
Last updated	July 21, 2026
Repository	Octodamus/octodamus-core ↗

How do I connect Octodamus Intelligence Oracle to my MCP client?

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

Who is it for?

Teams wiring Octodamus Intelligence Oracle into Claude, Cursor, or custom agents for finance.

Skip if: Skip when you need a non-MCP SDK or hosted API without stdio/SSE transport.

What you get

Working Octodamus Intelligence Oracle MCP server with verified tool registration and client config.

Live MCP connection to Octodamus Intelligence Oracle
Per-call crypto, Polymarket, and congressional trade signal payloads in agent context
Research notes and validation inputs for fintech or trading MVPs

By the numbers

[object Object]

At a glance

Octodamus Intelligence Oracle capabilities & compatibility

Capabilities: octodamus intelligence oracle mcp tool registrat · octodamus intelligence oracle client configurati · octodamus intelligence oracle agent workflow int
Use cases: orchestration
Runs: Remote server

From the docs

What Octodamus Intelligence Oracle says it does

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

README.md

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

README.md

Tools 10

Public tool metadata - what this server can do for an agent.

get_agent_signal1 param

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)

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

get_polymarket_edge1 param

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.

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

get_sentiment2 params

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.

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.
symbolstringAsset to filter by: "BTC", "ETH", or "SOL". Leave empty ("") to get scores for all assets.

get_prices1 param

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.

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

get_market_brief1 param

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

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

get_all_data1 param

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.

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

get_oracle_signals1 param

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}, {"

api_keystringOctoData API key (format: octo_...). Free key (500 req/day): POST https://api.octodamus.com/v1/signup?email=YOUR_EMAIL. Premium key (10k req/day): call get_premium_api() or GET /v1/subscribe?plan=trial.

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_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

README.md

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