get_token_poolsLABSCO SUMMARY
Every version of a pool in one table.
Liquidity for a token is spread across three protocol versions; this returns all of them together with fee tier and volume, so "where does this actually trade" is one answer instead of three.
What it is
A Python server over The Graph's Uniswap subgraphs. Give it a token address and get_token_pools returns that token's V2, V3 and V4 pools and pairs as a Markdown table; give it a version and a pool ID and it returns that pool's summary, including both token addresses.
What you get
- All pools and pairs for one token across V2, V3 and V4 in a single call
- The table carries version, ID, pair, fee tier, volume USD, liquidity or reserve USD and fees USD — enough to rank without a second lookup
- A single pool or pair by version and ID, returned as a written summary with the addresses of both tokens in it
Requirements
Python 3.10 or higher with uv, and a The Graph API key in the environment — the subgraphs it queries require one. Install into Claude Desktop with uv run mcp install main.py.
Setup effort
Build from source — clone the repository, then follow the project's own run instructions
USE CASES
01
Finding where a token has liquidity
One address returns its V2, V3 and V4 pools together, with the volume and liquidity columns to rank them by.
02
Choosing a fee tier to trade against
Fee tier sits next to volume and liquidity for every pool, so the trade-off is visible in one place.
03
Reading one pool in detail
Version plus pool ID returns that pool's summary and both token addresses — what you need before building a call against it.
2 tools
Listed in project docs. Your client may show a different list.
get_pool_dataBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- Python Version 3.10
- THEGRAPH_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uv run mcp install main.py --name "Uniswap Pools"MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"Uniswap Pools": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_UNISWAP_POOLS_MCP>",
"run",
"main.py"
],
"env": {
"THEGRAPH_API_KEY": "<YOUR_THEGRAPH_API_KEY>"
}
}
}
}
