Chainlink Feeds MCP Server

An MCP server that provides real-time access to Chainlink's decentralized on-chain price feeds, optimized for seamless integration into AI agents and autonomous systems

Features

• Query Latest Price: Fetch the latest price for a specified price feed pair (e.g., FIL/ETH) on a given chain (e.g., ethereum), including price, decimals, round ID, and timestamp.
• Query Price by Round ID: Retrieve price data for a specific round ID (currently a placeholder due to on-chain historical data limitations).
• List Supported Chains: Get a comma-separated list of supported blockchain networks (e.g., ethereum,base).
• List All Feeds: Retrieve a Markdown-formatted list of all chains and their price feed names (e.g., - ethereum: FIL/ETH,FDUSD/USD).
• List Feeds by Chain: Obtain a comma-separated list of price feed names for a specific chain (e.g., FIL/ETH,FDUSD/USD for ethereum).
• Configurable Feeds: Define price feeds and RPC endpoints in a feeds.json file, supporting multiple chains and feed categories.

Supported Chains and Feeds

The server supports 9 blockchain networks with a total of 329 price feeds, as defined in feeds.json:

• Ethereum: 107 feeds (e.g., FIL/ETH, BTC/USD, USDC/USD)
• BNB Chain (bsc): 80 feeds (e.g., DOT/USD, CAKE/USD, BUSD/BNB)
• Base: 52 feeds (e.g., AXL/USD, USDC/USD, WIF/USD)
• Starknet: 9 feeds (e.g., ETH/USD, BTC/USD, WSTETH/ETH)
• Linea: 15 feeds (e.g., ETH/USD, FOXY/USD, MATIC/USD)
• Mantle: 6 feeds (e.g., MNT/USD, USDT/USD, BTC/USD)
• Scroll: 22 feeds (e.g., SCR/USD, STETH/USD, WBTC/BTC)
• zkSync: 16 feeds (e.g., ZK/USD, PEPE/USD, TRUMP/USD)
• Celo: 22 feeds (e.g., CELO/USD, CUSD/USD, NGN/USD)

Additional chains and feeds can be added by updating feeds.json with new network configurations and proxy addresses from Chainlink's Price Feeds documentation.

Prerequisites

• Node.js: Version 18.x or higher.
• npm: For dependency installation.
• Infura API Key: Obtain a key from the MetaMask Developer Dashboard with access to supported networks (e.g., Ethereum, Base).
• MCP Inspector (optional): For testing the server locally.
• Claude Desktop (optional): For integration with Anthropic's Claude interface.

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/chainlink-feeds-mcp.git
   cd chainlink-feeds-mcp
   

2. Install Dependencies:

   npm install
   

   The project requires:

   • @modelcontextprotocol/sdk: For MCP server functionality.
   • ethers: Version 6.x for blockchain interactions.
   • zod: For input validation.
   • dotenv: For environment variable management.

3. Configure MCP Client: To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):

   {
     "mcpServers": {
       "chainlink-feeds-mcp": {
         "command": "node",
         "args": ["path/to/chainlink-feeds-mcp/index.js"],
         "env": { "INFURA_API_KEY": "your_api_key_here" }
       }
     }
   }   
   

4. Create a .env file in the root directory and add your Infura API key:

   INFURA_API_KEY=your_infura_api_key_here
   

   You can get a free key from Infura.

Running the server

To start the server, run the following command:

npm start

Debugging in VS Code

This project is pre-configured for debugging index.ts in Visual Studio Code.

1. Make sure you have installed the dependencies (npm install).
2. Open the project folder in VS Code.
3. Navigate to the "Run and Debug" view (you can use the shortcut Cmd+Shift+D on macOS or Ctrl+Shift+D on Windows/Linux).
4. Select "Debug index.ts" from the configuration dropdown menu at the top.
5. Press the "Start Debugging" button (the green play icon) or F5.

The debugger will launch the TypeScript server using ts-node, and you can set breakpoints in your .ts files.

Usage

The server exposes five tools via the MCP protocol, accessible through Claude Desktop (for natural language queries) or MCP Inspector (for JSON inputs). Below are the tools, with examples in both natural language (via Claude Desktop) and JSON formats.

Tool: getLatestPrice

• Description: Fetches the latest price for a given pair on a specified chain, returns a JSON object like this:

  {
    "chain": "ethereum",
    "pair": "FIL/ETH",
    "price": 0.01234,
    "decimals": 18,
    "roundId": "123456",
    "timestamp": "2025-04-17T12:00:00.000Z",
    "proxyAddress": "0x0606Be69451B1C9861Ac6b3626b99093b713E801",
    "feedCategory": "medium"
  }
  

• Parameters:

  • pair (string): The price feed pair, e.g., FIL/ETH.
  • chain (string): The blockchain network, e.g., ethereum.

• Natural Language Example (Claude Desktop):

  Input: "What��s the latest FIL/ETH price on Ethereum?"

  Output: "The latest FIL/ETH price on Ethereum is 0.01234, with 18 decimals, round ID 123456, updated at 2025-04-17 12:00:00 UTC."

Tool: queryPriceByRound

• Description: Queries the price for a given pair and round ID on a specified chain, returns a JSON object like this:

  {
    "chain": "ethereum",
    "pair": "FDUSD/USD",
    "price": 1.0001,
    "decimals": 8,
    "roundId": "123",
    "timestamp": "2025-04-17T12:00:00.000Z",
    "proxyAddress": "0xfAA9147190c2C2cc5B8387B4f49016bDB3380572",
    "feedCategory": "medium"
  }
  

• Parameters:

  • roundId (string): The round ID for the price data.
  • pair (string): The price feed pair, e.g., FDUSD/USD.
  • chain (string): The blockchain network, e.g., ethereum.

• Natural Language Example (Claude Desktop):

  Input: "Can you get the FDUSD/USD price for round ID 123 on Ethereum?"

  Output: "For round ID 123, the FDUSD/USD price on Ethereum is 1.0001, with 8 decimals, updated at 2025-04-17 12:00:00 UTC. Note: This is a placeholder response due to historical data limitations."

Tool: listSupportedChains

• Description: Returns a comma-separated list of all supported blockchain networks.

• Parameters: None.

• Natural Language Example (Claude Desktop):

  Input: "Which blockchain networks does this server support?"

  Output: "The server supports the following networks: ethereum, bsc, base, starknet, linea, mantle, scroll, zksync, celo."

Tool: listSupportedFeeds

• Description: Returns a Markdown list of all supported chains and their price feed names.

• Parameters: None.

• Natural Language Example (Claude Desktop):

  Input: "Can you list all the price feeds supported by the server?"

  Output: "Here are the supported price feeds by chain:

  • Ethereum: FIL/ETH, FDUSD/USD, UNI/ETH, ...

working in progress

1. Original repo: https://github.com/kukapay/chainlink-feeds-mcp, index.js not working

2. Used ai.studio and MCP llms.txt to have created a working index.ts

3. How to use: .vscode/mcp.json

Notice the --prefix vs uv --directory

    ...
    "chainlink-feeds-mcp": {
      "command": "npm",
      "args": [
        "--prefix",
        "/Users/xxx/xxxx/_github/kukapay/chainlink-feeds-mcp", 
        "run",
        "start" 
      ],
      "env": { "INFURA_API_KEY": "0d2xxxxxxcfac96a1dfd" }
    },