Uniswap Pools MCP Server

An MCP server for querying Uniswap pools/pairs by token address, delivering clean, structured results for easy integration and analysis.

Local serverstdioPython

What is the Uniswap Pools MCP Server?

An MCP server for querying Uniswap pools/pairs by token address, delivering clean, structured results for easy integration and analysis.

What you get

  • 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

Configuration and credentials

  • 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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Parameters- version (str): Uniswap version (v2, v3, or v4).
ExamplePrompt:
pool_idstr): Ethereum address of the pool or pair (e.g., 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc).
Versionv2
ID0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
PairUSDC/WETH

How to install the Uniswap Pools MCP Server

{
  "mcpServers": {
    "Uniswap Pools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/uniswap-pools-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "THEGRAPH_API_KEY": "YOUR_THEGRAPH_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • 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.
VariableDescriptionRequired
THEGRAPH_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Uniswap Pools MCP to Description.”
  • “Use Uniswap Pools MCP to Parameters.”
  • “Use Uniswap Pools MCP to Output.”

Frequently asked questions

An MCP server for querying Uniswap pools/pairs by token address, delivering clean, structured results for easy integration and analysis. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.