base-price-oracle-mcp
base-price-oracle-mcp
MCP server for real-time Base chain token price data from on-chain DEX pools. Pure on-chain reads via ethers.js -- no external APIs, no API keys needed.
Install
npx -y base-price-oracle-mcpOr add to your MCP config:
{
"mcpServers": {
"base-price-oracle": {
"command": "npx",
"args": ["-y", "base-price-oracle-mcp"],
"env": {
"RPC_URL": "https://mainnet.base.org"
}
}
}
}Related MCP server: o1-mcp
Tools (7)
Tool | Description |
| Current price from Uniswap V2/V3 and Aerodrome pools |
| Recent price data points from swap events |
| Price volatility (stddev of returns) from recent swaps |
| Pool reserves and liquidity across all DEXes |
| Estimated price impact for a given trade size |
| Cross-DEX price comparison (arbitrage finder) |
| Combined report: price, volume, liquidity, volatility |
Data Sources
Uniswap V2 (Factory:
0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6)Uniswap V3 (Factory:
0x33128a8fC17869897dcE68Ed026d694621f6FDfD)Aerodrome (Factory:
0x420DD381b31aEf6683db6B902084cB0FFECe40Da)
Environment Variables
Variable | Default | Description |
|
| Base mainnet RPC endpoint |
Related MCP Servers
Package | Tools | What it does |
| 14 | Deploy tokens, trade, earn OBSD |
| 8 | Scan contracts for vulnerabilities |
| 7 | On-chain price feeds from DEX pools |
| 8 | Coordinated multi-wallet trading |
| 5 | Gasless ERC-20 token deployment |
| 7 | Detect arbitrage opportunities |
| 5 | Discover & trade new launches |
| 7 | Wallet balances, gas, tokens |
| 6 | Read any smart contract (free) |
| - | Scaffold a new MCP server |
License
MIT
Available Tools
7 toolscompare_pricesC
Compare a token's price across multiple DEX pools to find arbitrage opportunities
Inputs: token_address (required).
get_liquidity_depthC
Check pool reserves and liquidity depth for a token across all DEXes
Inputs: token_address (required).
get_market_summaryC
Combined report: price, volume estimate, liquidity, volatility for a token
Inputs: token_address (required).
get_price_historyB
Get recent price data points by querying swap events from DEX pools
Inputs: token_address (required), periods, interval.
get_price_impactC
Estimate price impact for a given trade size using constant product formula
Inputs: token_address (required), trade_size_eth (required).
get_token_priceB
Get current price of any Base token from on-chain DEX pools (Uniswap V2/V3, Aerodrome)
Inputs: token_address (required), quote_currency.
get_volatilityB
Calculate price volatility (standard deviation of returns) from recent swaps
Inputs: token_address (required), lookback_hours.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: compare_prices focuses on arbitrage, get_liquidity_depth on reserves, get_market_summary on aggregated reports, get_price_history on historical data, get_price_impact on trade simulation, get_token_price on current pricing, and get_volatility on volatility metrics. The descriptions make it easy to differentiate between them.
All tools follow a consistent verb_noun pattern using snake_case (e.g., compare_prices, get_liquidity_depth, get_market_summary). The naming is uniform and predictable across all seven tools, with no deviations in style or convention.
With 7 tools, the count is well-scoped for a price oracle server focused on Base token analysis. Each tool serves a specific function in the domain of DEX price data, liquidity, and market metrics, with no redundancy or missing essential operations.
The toolset provides complete coverage for price oracle functionality on Base tokens, including current pricing (get_token_price), historical analysis (get_price_history), liquidity assessment (get_liquidity_depth), market summaries (get_market_summary), volatility (get_volatility), arbitrage detection (compare_prices), and trade impact simulation (get_price_impact). There are no obvious gaps for the stated purpose.
Related MCP Connectors
Live Base Mainnet on-chain data (gas, DEX, Aave, token risk, prices). Pay per call in USDC via x402.
Live Base Mainnet on-chain data (gas, DEX, Aave, token risk, prices). Pay per call in USDC via x402.
Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).
Peer protocol seller-rate and liquidity history on Base. Paid aggregate reads via x402 USDC.
Related MCP Servers
- AlicenseAqualityCmaintenanceArbitrage detection across DEXes on Base. Scan pairs, detect price gaps, estimate profit, simulate flash loan routes.737 npm1MIT
- AlicenseAqualityDmaintenanceProvides access to live swap quotes and routing on the Base network via the o1.exchange DEX aggregator. Read-only and safe by default, it returns routing data and unsigned calldata for you to sign in your own wallet.3MIT
- AlicenseNot gradedqualityCmaintenanceGet the best swap quotes across Uniswap, SushiSwap, Aerodrome with pay-per-call via x402 (USDC on Base).MIT
- AlicenseNot gradedqualityBmaintenanceProvides DEX price, liquidity, and volume data across multiple chains, including pair details, token pairs, search, and trending tokens.110 npm1MIT