Pythia Oracle MCP Server

Every smart contract deserves intelligence, not just data.

Pythia is the first oracle delivering calculated technical indicators on-chain — EMA, RSI, VWAP, Bollinger Bands, volatility — for any token, on any Chainlink-supported chain. The same indicators traders use, available to smart contracts and AI agents with a single call via Chainlink.

Pythia Events lets smart contracts subscribe to indicator conditions (RSI below 30, EMA crossover, Bollinger breakout) and get called automatically when they trigger. No keeper, no off-chain bot, no polling — your contract reacts to markets on its own.

Pythia Visions delivers walk-forward validated market intelligence on-chain — pattern type, confidence score, indicator snapshot, and feeds-to-watch for confirmation, all in one event. Backtested across 9 years of history. FREE to subscribe. For the current live token + pattern catalog with accuracy stats and fire frequency, call get_visions_info from the MCP tools below.

Why Pythia?

Most oracles only give you price. Pythia gives you computed analysis: EMA, RSI, Bollinger Bands, VWAP, volatility — for tokens like BTC, SOL, TAO, RENDER, ONDO, AAVE, UNI, and more, across 4 timeframes, delivered on-chain via Chainlink. New tokens and indicators are added on demand. If your AI agent, DeFi protocol, or trading bot needs on-chain RSI, EMA, or Bollinger Bands — Pythia is the only source.

Use cases:

• AI trading agents that need on-chain technical signals
• DeFi vault rebalancing based on RSI or volatility thresholds
• Smart contract risk management using Bollinger Band width
• AI-powered portfolio analysis with real-time calculated metrics
• Event-driven strategies — subscribe to RSI thresholds or EMA crossovers, your contract gets triggered automatically
• Automated DeFi bots without keepers — no Gelato, no cron jobs, no off-chain infrastructure

Quick Start

pip install pythia-oracle-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "pythia-oracle": {
      "command": "pythia-oracle-mcp"
    }
  }
}

Claude Code

claude mcp add pythia-oracle -- pythia-oracle-mcp

Cursor / Windsurf / VS Code

Add to MCP settings:

{
  "pythia-oracle": {
    "command": "pythia-oracle-mcp"
  }
}

OpenAI Agents / GPT

Any MCP-compatible client works — just point it at pythia-oracle-mcp.

Run directly

python -m pythia_oracle_mcp

Available Tools

Example Prompts

Ask your AI agent:

"What indicators does Pythia have for Bitcoin?"

Calls get_token_feeds("bitcoin") — returns all indicator feeds for Bitcoin, grouped by type.

"Is Pythia reliable enough to integrate?"

Calls check_oracle_health() — returns per-token uptime, data source health, and active incidents.

"Give me a Solidity contract to consume Pythia's speed bundle"

Calls get_integration_guide("speed") — returns a complete, deployable contract with correct addresses and job IDs.

"What tokens does Pythia cover and are they all working?"

Calls get_market_summary() — returns ecosystem coverage, status breakdown, and infrastructure health.

"How do Pythia Events work? I want my contract to react when BTC RSI drops below 30."

Calls get_events_info() — returns how subscriptions work, supported conditions, and pricing.

"Give me the Solidity code to subscribe to an EMA crossover event."

Calls get_events_guide() — returns a deployable EventSubscriber contract with subscribe/receive pattern.

"What are Pythia Visions? What patterns does it detect?"

Calls get_visions_info() — returns walk-forward validated patterns with accuracy range, fire frequency, contract address, and how it works.

"Show me recent BTC Visions that fired"

Calls get_vision_history("BTC") — returns recent pattern detections with confidence and price.

"Give me Solidity code to subscribe to Pythia Visions"

Calls get_visions_guide() — returns a contract that subscribes to VisionFired events.

What Pythia Provides

• Any token, any Chainlink-supported chain — currently serving BTC, SOL, TAO, RENDER, ONDO, AAVE, UNI, MORPHO, and more, with new tokens added on demand
• 6 indicator types: EMA, RSI, Bollinger Bands (upper/lower), VWAP, Volatility, USD Price
• 4 timeframes: 5-minute, 1-hour, 1-day, 1-week
• 4 pricing tiers: Discovery / Analysis / Speed / Complete — for current LINK fees call get_pricing
• Free trial: PythiaFaucet contract — no LINK needed
• Pythia Events: Subscribe to indicator conditions (ABOVE/BELOW thresholds) — your contract gets called when they trigger. Prepaid in LINK, unused time refunded on cancel or fire. No keeper infrastructure needed.
• Pythia Visions: Walk-forward validated market intelligence on-chain — pattern type + confidence + indicator snapshot + feeds-to-watch, delivered via Chainlink. FREE to subscribe. For the live list of patterns + tokens, call get_visions_info.
• Public indicator history: free, immutable JSON archive of every published indicator value — one file per feed per closed UTC day at https://pythia.c3x-solutions.com/history/{chain}/{feed_name}/{YYYY-MM-DD}.json (start from history/manifest.json). Re-derive or audit any indicator condition over a date range without an oracle call; files never change once published.

Data Freshness

This MCP server is a thin client over https://pythia.c3x-solutions.com/feed-status.json, the live status feed updated every 15 minutes by the data engine. New tokens, new patterns, contract addresses, and pricing changes appear in MCP tools within seconds of the next data-engine cycle — no package update required.

If the live feed is unreachable, MCP tools raise a clear error rather than serve stale baked-in data. Retry shortly or check status. (As of v0.9.0, fail-loud — earlier versions had baked-in fallbacks that drifted from production state and have been removed.)

Integration Examples

See pythia-oracle-examples for Solidity contracts with Hardhat setup — ready to deploy on any Chainlink-supported network.

Links

• Website & Live Feed Explorer
• Integration Examples (Solidity + Hardhat)
• PyPI Package
• Telegram
• Twitter/X

License

MIT