io.github.lordbasilaiassistant-sudo/base-flash-arb-mcp
MCP server for AI agents to detect flash loan arbitrage opportunities across DEXes on Base. Scan Uni
Open source Open in the app JSON README (API)
About
MCP server for AI agents to detect flash loan arbitrage opportunities across DEXes on Base. Scan Uni
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- lordbasilaiassistant-sudo
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Stars
- 1
- Forks
- 1
- Last push
- 2026-08-27T14:32:31Z
- 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-flash-arb-mcp
README
# base-flash-arb-mcp
MCP server for detecting flash loan arbitrage opportunities across DEXes on Base mainnet.
## Tools
| Tool | Description |
|------|-------------|
| `detect_arb_opportunity` | Compare token prices across Uniswap V2, V3, and Aerodrome. Find profitable arb routes. |
| `get_pool_reserves` | Get reserves/liquidity for a token across all known DEX pools on Base. |
| `estimate_flash_profit` | Estimate flash loan profit between two pools after gas costs. |
| `scan_top_tokens` | Scan top traded tokens on Base for arb opportunities via DexScreener. |
| `get_price_across_dexes` | Get current price of a token on all available DEXes. |
| `check_sandwich_risk` | Analyze recent trades for sandwich attack patterns (bot activity). |
| `get_mempool_pending` | Check pending transactions for front-run detection. |
## Install
```bash
npx -y base-flash-arb-mcp
```
## Configuration
Set `RPC_URL` environment variable to override the default Base RPC (`https://mainnet.base.org`).
### Claude Desktop
```json
{
"mcpServers": {
"base-flash-arb": {
"command": "npx",
"args": ["-y", "base-flash-arb-mcp"],
"env": {
"RPC_URL": "https://mainnet.base.org"
}
}
}
}
```
## DEXes Covered
- Uniswap V2 (Factory: `0x8909Dc15e40173Ff4699343b6eB8132c65e18eC6`)
- Uniswap V3 (Fee tiers: 0.05%, 0.3%, 1%)
- Aerodrome (Volatile + Stable pools)
## How It Works
All tools are **read-only** -- no private key needed. The server queries on-chain pool reserves, uses DEX quoters for accurate pricing, and compares across exchanges to find price discrepancies that could be exploited via flash loans.
Flash profit estimation accounts for:
- Aave flash loan fee (0.09%)
- Base gas costs (dynamically estimated)
- Slippage warning
Sandwich detection uses heuristic analysis of Swap events to identify same-block multi-transaction patterns from single addresses.
## 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