# 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