uniswap-pools-mcp

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

4 stars PythonOthers Updated Aug 9, 2025

Documentation

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.

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

1. Clone the Repository:

bash

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

2. Install Dependencies:

bash

uv sync

3. Installing to Claude Desktop:

Install the server as a Claude Desktop application:

bash

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

Configuration file as a reference:

json

{
       "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-mcp` with your actual installation path, and `thegraph-api-key` with your API key from The Graph.

Usage

The server provides several tools to query Uniswap pool/pair data.

Tools

1. Get All Pools/Pairs for a Token:

python

def get_token_pools(token_address: str) -> str:

Prompt:

code

Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Output:

code

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

2. Get Specific Pool/Pair by Version and ID:

python

def get_pool_data(version: str, pool_id: str) -> str:

Prompt:

code

Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc

Output:

code

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

Frequently asked questions

What is uniswap-pools-mcp?

uniswap-pools-mcp is An MCP server for querying Uniswap pools/pairs by token address.

How do I install uniswap-pools-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is uniswap-pools-mcp open source?

Yes — it is hosted on GitHub at https://github.com/kukapay/uniswap-pools-mcp and has 4 stars.

Related MCP tools

cognee

Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.

30,433 Python

agent-memoryagent-skillsai+16

skyvern

Automate browser based workflows with AI

22,930 Python

apiautomationbrowser+13

hindsight

Hindsight: Agent Memory That Learns

22,468 Python

agentic-aimemoryagents+1

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

20,504 Python

agent-skillaic2pa+12

Qwen-Agent

Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.

17,062 Python

pal-mcp-server

The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.

11,731 Python

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP