Chainlink Feeds MCP Server

1# Chainlink Feeds MCP Server
2 
3An 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
4 
5<a href="https://glama.ai/mcp/servers/@kukapay/chainlink-feeds-mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kukapay/chainlink-feeds-mcp/badge" alt="chainlink-feeds-mcp MCP server" />
7</a>
8 
9[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
10[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
11![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
12 
13## Features
14 
15- **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.
16- **Query Price by Round ID**: Retrieve price data for a specific round ID (currently a placeholder due to on-chain historical data limitations).
17- **List Supported Chains**: Get a comma-separated list of supported blockchain networks (e.g., `ethereum,base`).
18- **List All Feeds**: Retrieve a Markdown-formatted list of all chains and their price feed names (e.g., `- ethereum: FIL/ETH,FDUSD/USD`).
19- **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`).
20- **Configurable Feeds**: Define price feeds and RPC endpoints in a `feeds.json` file, supporting multiple chains and feed categories.
21 
22## Supported Chains and Feeds
23 
24The server supports **9 blockchain networks** with a total of **329 price feeds**, as defined in `feeds.json`:
25 
26- **Ethereum**: 107 feeds (e.g., `FIL/ETH`, `BTC/USD`, `USDC/USD`)
27- **BNB Chain (bsc)**: 80 feeds (e.g., `DOT/USD`, `CAKE/USD`, `BUSD/BNB`)
28- **Base**: 52 feeds (e.g., `AXL/USD`, `USDC/USD`, `WIF/USD`)
29- **Starknet**: 9 feeds (e.g., `ETH/USD`, `BTC/USD`, `WSTETH/ETH`)
30- **Linea**: 15 feeds (e.g., `ETH/USD`, `FOXY/USD`, `MATIC/USD`)
31- **Mantle**: 6 feeds (e.g., `MNT/USD`, `USDT/USD`, `BTC/USD`)
32- **Scroll**: 22 feeds (e.g., `SCR/USD`, `STETH/USD`, `WBTC/BTC`)
33- **zkSync**: 16 feeds (e.g., `ZK/USD`, `PEPE/USD`, `TRUMP/USD`)
34- **Celo**: 22 feeds (e.g., `CELO/USD`, `CUSD/USD`, `NGN/USD`)
35 
36Additional chains and feeds can be added by updating `feeds.json` with new network configurations and proxy addresses from Chainlink's Price Feeds documentation.
37 
38## Prerequisites
39 
40- **Node.js**: Version 18.x or higher.
41- **npm**: For dependency installation.
42- **Infura API Key**: Obtain a key from the [MetaMask Developer Dashboard](https://infura.io/) with access to supported networks (e.g., Ethereum, Base).
43- **MCP Inspector** (optional): For testing the server locally.
44- **Claude Desktop** (optional): For integration with Anthropic's Claude interface.
45 
46## Installation
47 
481. **Clone the Repository**:
49   ```bash
50   git clone https://github.com/kukapay/chainlink-feeds-mcp.git
51   cd chainlink-feeds-mcp
52   ```
53 
542. **Install Dependencies**:
55   ```bash
56   npm install
57   ```
58   The project requires:
59   - `@modelcontextprotocol/sdk`: For MCP server functionality.
60   - `ethers`: Version 6.x for blockchain interactions.
61   - `zod`: For input validation.
62   - `dotenv`: For environment variable management.
63 
643. **Configure MCP Client**:
65   To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
66    ```json
67    {
68      "mcpServers": {
69        "chainlink-feeds-mcp": {
70          "command": "node",
71          "args": ["path/to/chainlink-feeds-mcp/index.js"],
72          "env": { "INFURA_API_KEY": "your_api_key_here" }
73        }
74      }
75    }   
76    ```
77## Usage
78 
79The 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.
80 
81### Tool: `getLatestPrice`
82 
83- **Description**: Fetches the latest price for a given pair on a specified chain, returns a JSON object like this:
84    ```json
85    {
86      "chain": "ethereum",
87      "pair": "FIL/ETH",
88      "price": 0.01234,
89      "decimals": 18,
90      "roundId": "123456",
91      "timestamp": "2025-04-17T12:00:00.000Z",
92      "proxyAddress": "0x0606Be69451B1C9861Ac6b3626b99093b713E801",
93      "feedCategory": "medium"
94    }
95    ```
96 
97- **Parameters**:
98  - `pair` (string): The price feed pair, e.g., `FIL/ETH`.
99  - `chain` (string): The blockchain network, e.g., `ethereum`.
100 
101- **Natural Language Example (Claude Desktop)**:
102  
103  > **Input**: "What¡¯s the latest FIL/ETH price on Ethereum?"
104  
105  > **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."
106 
107 
108### Tool: `queryPriceByRound`
109 
110- **Description**: Queries the price for a given pair and round ID on a specified chain, returns a JSON object like this:
111    ```json
112    {
113      "chain": "ethereum",
114      "pair": "FDUSD/USD",
115      "price": 1.0001,
116      "decimals": 8,
117      "roundId": "123",
118      "timestamp": "2025-04-17T12:00:00.000Z",
119      "proxyAddress": "0xfAA9147190c2C2cc5B8387B4f49016bDB3380572",
120      "feedCategory": "medium"
121    }
122    ```
123 
124 
125- **Parameters**:
126  - `roundId` (string): The round ID for the price data.
127  - `pair` (string): The price feed pair, e.g., `FDUSD/USD`.
128  - `chain` (string): The blockchain network, e.g., `ethereum`.
129 
130- **Natural Language Example (Claude Desktop)**:
131  
132  > **Input**: "Can you get the FDUSD/USD price for round ID 123 on Ethereum?"
133  
134  > **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."
135 
136### Tool: `listSupportedChains`
137 
138- **Description**: Returns a comma-separated list of all supported blockchain networks.
139 
140- **Parameters**: None.
141 
142- **Natural Language Example (Claude Desktop)**:
143  
144  > **Input**: "Which blockchain networks does this server support?"
145  
146  > **Output**: "The server supports the following networks: ethereum, bsc, base, starknet, linea, mantle, scroll, zksync, celo."
147 
148 
149### Tool: `listSupportedFeeds`
150 
151- **Description**: Returns a Markdown list of all supported chains and their price feed names.
152 
153- **Parameters**: None.
154 
155- **Natural Language Example (Claude Desktop)**:
156 
157  > **Input**: "Can you list all the price feeds supported by the server?"
158  
159  > **Output**: "Here are the supported price feeds by chain:
160    - Ethereum: FIL/ETH, FDUSD/USD, UNI/ETH, ...
161    - BNB Chain: DOT/USD, CAKE/USD, BUSD/BNB, ...
162    - Base: AXL/USD, USDC/USD, WIF/USD, ...
163    - Starknet: ETH/USD, BTC/USD, WSTETH/ETH, ...
164    - Linea: ETH/USD, FOXY/USD, MATIC/USD, ...
165    - Mantle: MNT/USD, USDT/USD, BTC/USD, ...
166    - Scroll: SCR/USD, STETH/USD, WBTC/BTC, ...
167    - zkSync: ZK/USD, PEPE/USD, TRUMP/USD, ...
168    - Celo: CELO/USD, CUSD/USD, NGN/USD, ..."
169 
170 
171### Tool: `listSupportedFeedsByChain`
172 
173- **Description**: Returns a comma-separated list of price feed names for a specified blockchain network.
174 
175- **Parameters**:
176  - `chain` (string): The blockchain network, e.g., `base`.
177 
178- **Natural Language Example (Claude Desktop)**:
179  > **Input**:  "What price feeds are available on the Base chain?"
180  
181  > **Output**: "The Base chain supports the following price feeds: AXL/USD, USDC/USD, WIF/USD, CBETH/ETH, ..."
182 
183 
184## License
185 
186This project is licensed under the [MIT License](LICENSE).