uniswap-pools-mcp
Allows querying Uniswap pools/pairs on the Ethereum blockchain by token address, retrieving details such as volume, liquidity, and fees for V2, V3, and V4 pools.
References GitHub for repository access and license information, with the MCP server code hosted and available at a GitHub repository.
Formats query results as markdown tables and text summaries, providing structured outputs for pool data including token pairs, addresses, fee tiers, and financial metrics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@uniswap-pools-mcp get Uniswap pools for USDC token"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Uniswap Pools MCP
An MCP server for querying Uniswap pools/pairs by token address, delivering clean, structured results for easy integration and analysis.
Features
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.
Formatted Output:
Returns data in markdown tables for combined pool queries.
Provides markdown text summaries for specific pool/pair queries, including token addresses.
Related MCP server: uniswap-poolspy-mcp
Installation
Prerequisites
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 from The Graph.
Setup
Clone the Repository:
git clone https://github.com/kukapay/uniswap-pools-mcp.git cd uniswap-pools-mcpInstall Dependencies:
uv syncInstalling to Claude Desktop:
Install the server as a Claude Desktop application:
uv run mcp install main.py --name "Uniswap Pools"Configuration file as a reference:
{ "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.
Usage
The server provides several tools to query Uniswap pool/pair data.
Tools
Get All Pools/Pairs for a Token:
def get_token_pools(token_address: str) -> str:Description: Queries all Uniswap V2, V3, and V4 pools/pairs for a given token address.
Parameters:
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.
Example:
Prompt:
Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48Output:
| 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.Parameters:
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.
Example:
Prompt:
Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dcOutput:
**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
License
This project is licensed under the MIT License. See the LICENSE file for details.
Available Tools
5 toolsget_pool_dataA
Query a specific Uniswap pool/pair by version (v2, v3, v4) and ID and return as markdown text.
Parameters:
version (str): The Uniswap version to query ('v2', 'v3', or 'v4').
pool_id (str): The Ethereum address of the pool or pair to query (e.g., '0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc').
ctx (Context): The API context for logging and error handling.
Returns:
A markdown-formatted string containing details of the pool/pair, including Version, ID, Pair, Token0 Address,
Token1 Address, Fee Tier, Volume USD, Liquidity/ReserveUSD, and Fees USD.
Inputs: pool_id (required), version (required).
get_token_poolsA
Query all Uniswap V2, V3, and V4 pools/pairs for a specific token and return as a formatted markdown table.
Parameters:
token_address (str): The Ethereum address of the token to query (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48').
ctx (Context): The API context for logging and error handling.
Returns:
A markdown-formatted string containing a table with columns: Version, ID, Pair, Fee Tier, Volume USD, Liquidity/ReserveUSD, Fees USD, sorted by Volume USD in descending order.
Inputs: token_address (required).
get_token_pools_v2A
Query all Uniswap V2 pairs for a specific token and return as a formatted markdown table.
Parameters:
token_address (str): The Ethereum address of the token to query (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48').
ctx (Context): The API context for logging and error handling.
Returns:
A markdown-formatted string containing a table with columns: Version, ID, Pair, Volume USD, ReserveUSD.
Inputs: token_address (required).
get_token_pools_v3A
Query all Uniswap V3 pools for a specific token and return as a formatted markdown table.
Parameters:
token_address (str): The Ethereum address of the token to query (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48').
ctx (Context): The API context for logging and error handling.
Returns:
A markdown-formatted string containing a table with columns: Version, ID, Pair, Fee Tier, Volume USD, Liquidity.
Inputs: token_address (required).
get_token_pools_v4A
Query all Uniswap V4 pools for a specific token and return as a formatted markdown table.
Parameters:
token_address (str): The Ethereum address of the token to query (e.g., '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48').
ctx (Context): The API context for logging and error handling.
Returns:
A markdown-formatted string containing a table with columns: Version, ID, Pair, Fee Tier, Volume USD, Liquidity.
Inputs: token_address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
There is significant overlap between get_token_pools and the version-specific tools (get_token_pools_v2/v3/v4), as they all retrieve pools for a token with similar outputs. However, get_pool_data is clearly distinct for querying a specific pool by ID. The descriptions help clarify that get_token_pools aggregates across versions while others are version-specific, but agents might still be confused about when to use which.
The naming follows a consistent snake_case verb_noun pattern throughout (e.g., get_pool_data, get_token_pools). The only deviation is the addition of version suffixes (v2, v3, v4) for some tools, which is logical but slightly breaks the pure verb_noun convention. Overall, the naming is predictable and readable.
With 5 tools, the count is well-scoped for querying Uniswap pools, covering specific pool data and token-based queries across versions. It's slightly lean but reasonable, as each tool serves a purpose. A few more tools for broader operations (e.g., list_all_pools) could enhance it, but it's not a significant gap.
The toolset covers querying pools by ID and by token across Uniswap versions, which is a focused domain. However, there are notable gaps: no tools for creating, updating, or deleting pools (if applicable), and no broader operations like listing all pools or searching by other criteria. This limits agents to read-only queries, which may be sufficient but feels incomplete for full pool management.
Maintenance
Related MCP Connectors
MCP server for Fuse Network: balances, tokens, staking, DeFi data, swaps and on-chain transactions.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server implementation that enables access to DexScreener API data, providing real-time information on DEX pairs, token profiles, and market statistics across multiple blockchains.724-
- AlicenseBqualityDmaintenanceAn MCP server that tracks newly created liquidity pools on Uniswap across nine blockchain networks.110MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that delivers real-time token prices from Uniswap V3 across multiple chains.3MIT
- AlicenseAqualityDmaintenanceAn MCP server that tracks and analyzes DEX liquidity pools to power intelligent DeFi agents and automated strategies.12MIT