io.github.lordbasilaiassistant-sudo/base-price-oracle-mcp
MCP server for real-time token prices on Base from on-chain DEX pools.
Open source Open in the app JSON README (API)
About
MCP server for real-time token prices on Base from on-chain DEX pools.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- lordbasilaiassistant-sudo
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.3
- Stars
- 1
- Forks
- 1
- Last push
- 2026-08-27T14:33:47Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 04:00:26
- Updated
- 2026-08-29 04:00:26
- Origin id
io.github.lordbasilaiassistant-sudo/base-price-oracle-mcp
README
# 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
```bash
npx -y base-price-oracle-mcp
```
Or add to your MCP config:
```json
{
"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