Skip to main content

Every smart contract deserves intelligence, not just data. Pythia Oracle MCP server — on-chain calculated indicators via Chainlink.

Project description

Pythia Oracle MCP Server

PyPI License: MIT pythia-oracle-mcp 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.

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

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

Tool Description
list_tokens All tracked tokens with status, uptime, and data sources
get_token_feeds All indicator feed names for a specific token
get_market_summary System-wide overview — tokens by status, ecosystem coverage, infrastructure health
check_oracle_health Per-token 30-day uptime (worst-first), data source status, incident report
get_contracts All contract addresses (operator, consumers, faucet, LINK)
get_pricing Pricing tiers and when to use each one
get_integration_guide Ready-to-deploy Solidity code for any tier

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.

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 (0.01 LINK), Analysis (0.02), Speed (0.05), Complete (0.10)
  • Free trial: PythiaFaucet contract — no LINK needed, 5 requests/day

Integration Examples

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

Links

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pythia_oracle_mcp-0.3.0.tar.gz (14.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pythia_oracle_mcp-0.3.0-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file pythia_oracle_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: pythia_oracle_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 14.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for pythia_oracle_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 e3687f3d0927a7b08a5995521aa23a5eb9ffcb12d6c37502045c797c397c1d70
MD5 13f2d155f82ef0e805f43edba15bda3a
BLAKE2b-256 29ee1f187671f12257380b63dc9371436dd06f971a6564065a8b05a2bf227574

See more details on using hashes here.

File details

Details for the file pythia_oracle_mcp-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for pythia_oracle_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b6c0ddb590e9ebdd127cbb5c97c091fed611ed237d97b40cb9e1c261edd06f0f
MD5 1464f865358fafea6fae342c3b319bef
BLAKE2b-256 1786e823f21d137c7383887f1c5175d4dcc82fbb71c7411b91c1ef8c54313c8f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page