Uniswap V3 Price

An MCP server that delivers real-time token prices from Uniswap V3 across multiple chains.

javascript

2

GitHub Stars

javascript

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-price-mcp": {
      "command": "node",
      "args": [
        "path/to/uniswap-price-mcp/index.js"
      ],
      "env": {
        "INFURA_PROJECT_ID": "YOUR_INFURA_PROJECT_ID"
      }
    }
  }
}

You can run an MCP server that streams real-time Uniswap V3 token prices across multiple chains and use those prices in AI agents or DeFi automation workflows. It fetches prices by querying Uniswap V3 pools and can convert prices to USD when you enable it, making price data readily actionable for your automation stack.

How to use

You interact with the server using MCP-compatible clients. Start the local server, then request current token prices for any supported chain. You can ask for prices of tokens like DAI on Ethereum, or LINK on Polygon, and receive up-to-date values that reflect pool quotes. If you enable USD conversion, you’ll receive prices in USD as well.

How to install

Prerequisites you need before install are Node.js version 18 or higher and npm, plus an Infura account to obtain an INFURA_PROJECT_ID that grants access to Ethereum, Polygon, Arbitrum, and Optimism.

Step 1: Clone the project directory and navigate into it.

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

Step 2: Install dependencies.

npm install

Step 3: Configure the MCP client to run the server locally. Create or edit your MCP client configuration to include the following server entry. Replace your_infura_project_id with your actual Infura project ID.

{
  "mcpServers": {
    "Uniswap Price": {
      "command": "node",
      "args": ["path/to/uniswap-price-mcp/index.js"],
      "env": {
        "INFURA_PROJECT_ID": "your_infura_project_id"
      }
    }
  }
}

Additional configuration and notes

Supported chains are Ethereum Mainnet (1), Polygon (137), Arbitrum (42161), and Optimism (10). The server fetches token prices against USDT, USDC, or WETH in that order, and can retrieve symbol and decimals automatically. USD price conversion can be used as an optional enhancement via CryptoCompare.

When you run the server, you will typically start it with the node command and the path to the main script, passing the required environment variable INFURA_PROJECT_ID. Your MCP client will then be able to query for current token prices using the supported prompts.

Configuration notes

Environment variable you must provide in your run configuration is INFURA_PROJECT_ID. This value authenticates access to the supported networks through Infura.

Token prices can be requested in USD if you enable the optional USD conversion path described in the feature set. Ensure your client config includes the proper command and environment for the local MCP server so price data is available to downstream automation.

Usage examples and results

Get the price of DAI on the Ethereum Mainnet (chain 1). The response will be presented as a price value in the target quote token (USD if enabled). For example, you might see: Price of token DAI on chain 1 in USD: 1.00.

Get the USD price of Chainlink (LINK) on the Polygon network. You might see: Price of token LINK on chain 137 in USD: 18.50.

Available tools

getSupportedChains

Returns a list of all blockchain networks supported by the MCP server, including their chain IDs and names.

getTokenPrice

Fetches the current price of a given token on a specific chain, returning the price and the quote token used.

usdConversion

Optionally converts quoted prices to USD using a dedicated USD conversion path.