Uniswap Pools

An MCP server for querying Uniswap pools/pairs by token address.

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-uniswap-pools-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/uniswap-pools-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "THEGRAPH_API_KEY": "thegraph-api-key"
      }
    }
  }
}

You can query Uniswap pools and pairs across multiple versions directly from a single MCP server. This server returns structured results that you can easily feed into analytics, dashboards, or other tooling, making it simple to compare pools and monitor liquidity, volume, and fees across V2, V3, and V4 for a given token address.

How to use

You interact with this MCP server through an MCP client. Start the server using the included runtime, then issue queries to fetch all pools or to retrieve details for a specific pool by version and ID. You can compose prompts that request all pools for a token or target a single pool by version and ID. The server responds with clean markdown tables for listed pools and markdown-formatted summaries for specific pool details, including token addresses and fee tiers.

Common workflows you can perform include:

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

To fetch all pools for a token, supply the token address and request a combined table. - To fetch a single pool’s details, supply the version and pool ID, and you’ll receive a markdown block with Version, ID, Pair, Token0 Address, Token1 Address, Fee Tier, Volume USD, Liquidity/ReserveUSD, and Fees USD.

## How to install

Prerequisites you need before running the MCP server are installed Python, uv as the Python package manager, and an API key for The Graph.

Step 1: Clone the project directory

git clone https://github.com/kukapay/uniswap-pools-mcp.git cd uniswap-pools-mcp


Step 2: Synchronize dependencies with uv

uv sync


Step 3: Install the MCP as a Claude Desktop application (or run directly as an MCP) with the following command

uv run mcp install main.py --name "Uniswap Pools"


Configure the MCP server by providing the runtime command, working directory, and your Graph API key in the environment

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

## Additional configuration notes

The GRAPH API key must be valid and scoped for subgraph queries used by the Uniswap pools MCP. Replace the placeholder path with your actual installation path.

## Available tools

### get\_token\_pools

Fetches all Uniswap V2, V3, and V4 pools/pairs for a given token address and returns a markdown table with Version, ID, Pair, Fee Tier, Volume USD, Liquidity/ReserveUSD, and Fees USD.

### get\_pool\_data

Fetches details for a specific Uniswap pool/pair by version (v2, v3, or v4) and pool ID and returns a markdown text summary including Token0/Token1 addresses and fee tier.