Blocknative MCP Server

1# Blocknative MCP Server
2 
3An MCP server that provides real-time gas price predictions across multiple blockchains, powered by Blocknative.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/blocknative-mcp)
6![Python Version](https://img.shields.io/badge/python-3.10+-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Tools**:
12  - `predict_gas_price`: Fetches gas price predictions for a specified chain (default: Ethereum Mainnet, `chain_id=1`), including base fee and a table with confidence levels, price, max priority fee, and max fee.
13  - `estimate_gas_cost`: Estimates transaction costs based on gas limit, confidence level, and chain ID, returning costs in Gwei and ETH.
14  - `get_supported_chains`: Lists supported blockchains in a table with chain ID, system, and network.
15- **Prompt**:
16  - `gas_price_query`: A prompt template for querying gas prices at a specific confidence level and chain ID.
17- **Asynchronous**: Uses `httpx` for non-blocking HTTP requests to Blocknative's Gas Price and Chains APIs.
18- **Optional API Key**: Supports low-frequency access without a Blocknative API key; high-frequency use requires setting `BLOCKNATIVE_API_KEY`.
19 
20## Prerequisites
21 
22- **Python**: Version 3.10
23- **uv**: For dependency management and running the project ([installation guide](https://github.com/astral-sh/uv))
24- **Blocknative API Key** (optional): Required for high-frequency API access. Sign up at [Blocknative](https://www.blocknative.com/) to obtain a free API key.
25 
26## Installation
27 
281. **Clone the Repository**:
29   ```bash
30   git clone https://github.com/kukapay/blocknative-mcp.git
31   cd blocknative-mcp
32   ```
33 
342. **Set Up the Project with `uv`**:
35   ```bash
36   uv sync
37   ```
38 
393. **Set the Blocknative API Key (Optional)**:
40   - For high-frequency access, set the environment variable:
41     ```bash
42     export BLOCKNATIVE_API_KEY="your-api-key-here"
43     ```
44   - For low-frequency access, skip this step.
45 
46 
47## Usage
48 
49The server provides three tools and one prompt, accessible via the FastMCP framework. You can run the server in development mode, execute it directly, or integrate it with Claude Desktop.
50 
51### Running the Server
52 
531. **Development Mode with MCP Inspector**:
54   ```bash
55   uv run mcp dev blocknative-mcp
56   ```
57   This opens the MCP Inspector, a web interface for testing tools and prompts interactively.
58 
592. **Direct Execution**:
60   ```bash
61   uv run blocknative-mcp
62   ```
63 
643. **Claude Desktop Integration**:
65   ```bash
66   uv run mcp install blocknative-mcp --name "Blocknative MCP Server"
67   ```
68   This installs the server for use with Claude Desktop.
69 
70### Tools
71 
72- **`predict_gas_price(chain_id: int = 1) -> str`**:
73  Fetches gas price predictions for a chain (default: Ethereum Mainnet). Returns base fee and a Markdown table with confidence levels, price, max priority fee, and max fee.
74  - Example:
75    ```markdown
76    Gas Price Predictions for Chain ID 1 (ethereum/main):
77    - Base Fee Per Gas: 0.382910791 Gwei
78 
79    | Confidence | Price (Gwei) | Max Priority Fee (Gwei) | Max Fee (Gwei) |
80    |------------|--------------|-------------------------|----------------|
81    | 99%        | 0.52         | 0.14                    | 0.9            |
82    | 95%        | 0.48         | 0.094                   | 0.86           |
83    | 90%        | 0.47         | 0.089                   | 0.85           |
84    | 80%        | 0.46         | 0.079                   | 0.84           |
85    | 70%        | 0.45         | 0.069                   | 0.83           |
86    ```
87 
88- **`estimate_gas_cost(gas_limit: int, confidence: int = 99, chain_id: int = 1) -> str`**:
89  Estimates transaction costs based on gas limit, confidence level, and chain ID. Returns costs in Gwei and ETH.
90  - Example:
91    ```markdown
92    Estimated Gas Cost (Confidence 90%, Chain ID 1):
93    - Gas Limit: 21000
94    - Max Fee Per Gas: 0.85 Gwei
95    - Total Cost: 17850 Gwei (0.00001785 ETH)
96    ```
97 
98- **`get_supported_chains(ctx: Optional[Context] = None) -> str`**:
99  Lists supported chains in a Markdown table with chain ID, system, and network.
100  - Example:
101    ```markdown
102    Supported Chains:
103 
104    | Chain ID   | System   | Network   |
105    |------------|----------|-----------|
106    | 1          | ethereum | main      |
107    | 137        | polygon  | mainnet   |
108    | 8453       | base     | mainnet   |
109    | 11155111   | ethereum | sepolia   |
110    ```
111 
112### Prompts
113    
114- **`gas_price_query(confidence: int, chain_id: int = 1) -> List[base.Message]`**:
115  A prompt template for querying gas prices at a specific confidence level and chain ID.
116  - Example:
117    ```markdown
118    - User: What is the current gas price for chain ID 1 transactions with 90% confidence?
119    - Assistant: Let me fetch the gas price predictions for chain ID 1.
120    ```
121 
122 
123## License
124 
125This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
126 
127