Uniswap Pools MCP
About
Query Uniswap pools and pairs by token address for structured data.
Details
- Author
- kukapay
- Categories
- Database, Other
Jump to
Setup
Install Uniswap Pools MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kukapay/uniswap-pools-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server for querying Uniswap pools/pairs by token address, delivering clean, structured results for easy integration and analysis.
- Query Uniswap Pools/Pairs:
- Fetch V2, V3, and V4 pools/pairs for a given token address.
- Retrieve specific pool/pair details by version (v2,v3,v4) and ID.
- Returns data in markdown tables for combined pool queries.
- Provides markdown text summaries for specific pool/pair queries, including token addresses.
- Python: Version 3.10 or higher.
- uv: A Python package manager (recommended for dependency management).
- The Graph API Key: Required for querying Subgraphs. Obtain one fromThe Graph.
git clone https://github.com/kukapay/uniswap-pools-mcp.git cd uniswap-pools-mcp
Install the server as a Claude Desktop application:
uv run mcp install main.py --name "Uniswap Pools"
{ "mcpServers": { "Uniswap Pools": { "command": "uv", "args": [ "--directory", "/path/to/uniswap-pools-mcp", "run", "main.py" ], "env": { "THEGRAPH_API_KEY": "thegraph-api-key"} } } }
Replace/path/to/uniswap-pools-mcpwith your actual installation path, andthegraph-api-keywith your API key from The Graph.
The server provides several tools to query Uniswap pool/pair data.
def get_token_pools(token_address: str) -> str:
-
Description: Queries all Uniswap V2, V3, and V4 pools/pairs for a given token address.
- token_address(str): Ethereum address of the token (e.g.,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48for USDC).
Output: Markdown table with columns: Version, ID, Pair, Fee Tier, Volume USD, Liquidity/ReserveUSD, Fees USD.
Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
| Version | ID | Pair | Fee Tier | Volume USD | Liquidity/ReserveUSD | Fees USD | |---------|--------------------------------------------|-----------|----------|------------|---------------------|----------| | v2 | 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc | USDC/WETH | 3000 | 2000000.0 | 500000.0 | N/A | | v3 | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 | USDC/WETH | 500 | 1000000.0 | 123456789 | 5000.0 | | v4 | 0x1234567890abcdef1234567890abcdef12345678 | USDC/WETH | 1000 | 500000.0 | 987654321 | 2500.0 |
Get Specific Pool/Pair by Version and ID:
def get_pool_data(version: str, pool_id: str) -> str:
-
Description: Queries a specific Uniswap pool/pair by version (v2,v3, orv4) and ID.
- version(str): Uniswap version (v2,v3, orv4).
- pool_id(str): Ethereum address of the pool or pair (e.g.,0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc).
Output: Markdown text with details: Version, ID, Pair, Token0 Address, Token1 Address, Fee Tier, Volume USD, Liquidity/ReserveUSD, Fees USD.
Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
Uniswap V2 Pair Details - Version: v2 - ID: 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc - Pair: USDC/WETH - Token0 Address: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 - Token1 Address: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 - Fee Tier: 3000 (0.3%) - Volume USD: 2000000.0 - Liquidity/ReserveUSD: 500000.0 - Fees USD: N/A
This project is licensed under the MIT License. See theLICENSEfile for details.
Access Dune Analytics data for AI agents, including DEX metrics, EigenLayer stats, and Solana token balances.
Access real-time DEX analytics across 20+ blockchains with DexPaprika API, tracking 5M+ tokens, pools, volumes, and historical market data. Built by CoinPaprika.
Interact with the Aptos blockchain, supporting both testnet and mainnet for AI applications.
Interact with blockchain data using the Bankless API.
Agent Memory as a Service with x402 USDC micropayments on Base blockchain — provides memory_store, memory_recall, memory_forget, and memory_stats tools.
Per-byte USDC data feeds + oracles for AI agents on Arbitrum. 14 tools, EIP-712 attested payloads, no API keys, no token. MCP server for the BYTE Library catalog (18+ first-party publishers).
Real-time DeFi lending rates across 14+ protocols (Aave, Morpho, Spark, Compound, Venus, etc). Query borrow/supply rates, c ompare platforms, calculate looping strategies on 6 chains (Ethereum, Arbitrum, Base, BSC, Solana, HyperEVM).
Lyra Registry is a standalone API service that catalogs, scores, and serves metadata for all tools in the Lyra ecosystem. It enables discovery, evaluation, and integration of 800+ crypto, blockchain, DeFi, memecoin, NFT, metaverse, trading tools, MCP tools.
Access blockchain transaction data in natural language, providing human-readable descriptions for AI assistants.
Provides on-chain tools to interact with the Polygon PoS blockchain.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
