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.2.6.tar.gz (11.1 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.2.6-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pythia_oracle_mcp-0.2.6.tar.gz
  • Upload date:
  • Size: 11.1 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.2.6.tar.gz
Algorithm Hash digest
SHA256 19be2262c666e13d4ae6bda4e27c3c952396fc406e57cd396684529d4c04dd22
MD5 eb9460c08cd5475c7fc7dc50a45445ce
BLAKE2b-256 d5db78801baeae946b60107a8fcc391eae38644f1637e7d96e074fefff192332

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pythia_oracle_mcp-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 3dd402f89df156c2aa9770668d6e2888cdd99ce491a6a8e3590dd8ffb32ae8c3
MD5 b6dc4beb1081415cdd250226b75111d1
BLAKE2b-256 34685b48b97bdb661d81fbec27559313d646478721897d657c6c09ab5da093d5

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