Every smart contract deserves intelligence, not just data. Pythia Oracle MCP server — on-chain calculated indicators via Chainlink.
Project description
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.
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
- Website & Live Feed Explorer
- Integration Examples (Solidity + Hardhat)
- PyPI Package
- Telegram
- Twitter/X
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19be2262c666e13d4ae6bda4e27c3c952396fc406e57cd396684529d4c04dd22
|
|
| MD5 |
eb9460c08cd5475c7fc7dc50a45445ce
|
|
| BLAKE2b-256 |
d5db78801baeae946b60107a8fcc391eae38644f1637e7d96e074fefff192332
|
File details
Details for the file pythia_oracle_mcp-0.2.6-py3-none-any.whl.
File metadata
- Download URL: pythia_oracle_mcp-0.2.6-py3-none-any.whl
- Upload date:
- Size: 11.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3dd402f89df156c2aa9770668d6e2888cdd99ce491a6a8e3590dd8ffb32ae8c3
|
|
| MD5 |
b6dc4beb1081415cdd250226b75111d1
|
|
| BLAKE2b-256 |
34685b48b97bdb661d81fbec27559313d646478721897d657c6c09ab5da093d5
|