Base Price Oracle MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add base-price-oracle -- npx -y base-price-oracle-mcp
README.md

On-chain price feeds from Base DEX pools.

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-mcp

Or add to your MCP config:

{
  "mcpServers": {
    "base-price-oracle": {
      "command": "npx",
      "args": ["-y", "base-price-oracle-mcp"],
      "env": {
        "RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

Tools (7)

Tool Description
get_token_price Current price from Uniswap V2/V3 and Aerodrome pools
get_price_history Recent price data points from swap events
get_volatility Price volatility (stddev of returns) from recent swaps
get_liquidity_depth Pool reserves and liquidity across all DEXes
get_price_impact Estimated price impact for a given trade size
compare_prices Cross-DEX price comparison (arbitrage finder)
get_market_summary Combined report: price, volume, liquidity, volatility

Data Sources

  • Uniswap V2 (Factory: 0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6)
  • Uniswap V3 (Factory: 0x33128a8fC17869897dcE68Ed026d694621f6FDfD)
  • Aerodrome (Factory: 0x420DD381b31aEf6683db6B902084cB0FFECe40Da)

Environment Variables

Variable Default Description
RPC_URL https://mainnet.base.org Base mainnet RPC endpoint

Related MCP Servers

Package Tools What it does
obsd-launchpad-mcp 14 Deploy tokens, trade, earn OBSD
base-security-scanner-mcp 8 Scan contracts for vulnerabilities
base-price-oracle-mcp 7 On-chain price feeds from DEX pools
base-multi-wallet-mcp 8 Coordinated multi-wallet trading
base-gasless-deploy-mcp 5 Gasless ERC-20 token deployment
base-flash-arb-mcp 7 Detect arbitrage opportunities
base-token-sniper-mcp 5 Discover & trade new launches
base-wallet-toolkit-mcp 7 Wallet balances, gas, tokens
base-contract-reader-mcp 6 Read any smart contract (free)
create-mcp-server-cli - Scaffold a new MCP server

License

MIT

Tools (7)

get_token_priceCurrent price from Uniswap V2/V3 and Aerodrome pools
get_price_historyRecent price data points from swap events
get_volatilityPrice volatility (stddev of returns) from recent swaps
get_liquidity_depthPool reserves and liquidity across all DEXes
get_price_impactEstimated price impact for a given trade size
compare_pricesCross-DEX price comparison (arbitrage finder)
get_market_summaryCombined report: price, volume, liquidity, volatility

Environment Variables

RPC_URLBase mainnet RPC endpoint

Configuration

claude_desktop_config.json
{"mcpServers": {"base-price-oracle": {"command": "npx", "args": ["-y", "base-price-oracle-mcp"], "env": {"RPC_URL": "https://mainnet.base.org"}}}}

Try it

What is the current price of the token at address 0x... on Base?
Compare the price of this token across Uniswap and Aerodrome to find arbitrage opportunities.
What is the estimated price impact if I swap 10 ETH for this token?
Provide a market summary for the token at 0x... including its current liquidity and volatility.

Frequently Asked Questions

What are the key features of Base Price Oracle?

Real-time on-chain price feeds from Base DEX pools. Supports Uniswap V2, V3, and Aerodrome. Calculates price impact and liquidity depth. Analyzes price volatility and historical trends. Pure on-chain reads via ethers.js with no external API dependencies.

What can I use Base Price Oracle for?

DeFi traders looking to identify arbitrage opportunities across different DEXes. Developers building analytics dashboards for Base chain tokens. Users needing accurate price impact estimates before executing large swaps. Researchers analyzing historical price volatility and liquidity trends on Base.

How do I install Base Price Oracle?

Install Base Price Oracle by running: npx -y base-price-oracle-mcp

What MCP clients work with Base Price Oracle?

Base Price Oracle works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Base Price Oracle docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare