Gas Fee Predictor β MCP Server
Live Ethereum + Layer-2 gas-fee data for AI agents, via the
Model Context Protocol. Read-only, no API key,
no account. Every answer carries a citation back to
gasfeepredictor.com.
There are two ways to connect. Prefer the hosted one β there is nothing to install.
1. Hosted endpoint (recommended)
If your client supports remote MCP servers β ChatGPT and Claude connectors, Cursor,
VS Code, and most current clients do β paste this URL and you are done:
https://api.gasfeepredictor.com/api/mcp
Streamable HTTP, unauthenticated, no install, no config file, nothing to keep updated.
It exposes 7 tools β two more than the npm package (get_gas_forecast and
get_gas_history).
Client config, if your client wants JSON rather than a URL box
{
"mcpServers": {
"gasfeepredictor": {
"type": "streamable-http",
"url": "https://api.gasfeepredictor.com/api/mcp"
}
}
}
Verify it yourself:
curl -s -X POST https://api.gasfeepredictor.com/api/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
2. npm package (stdio)
For clients that speak stdio only. Requires Node β₯ 18.
{
"mcpServers": {
"gasfeepredictor": {
"command": "npx",
"args": ["-y", "gasfeepredictor-mcp"]
}
}
}
Claude Desktop keeps that file at
~/Library/Application Support/Claude/claude_desktop_config.json on macOS.
Restart the client, then ask: "What's the Ethereum gas fee right now, and is it
cheaper on an L2?"
| Env var | Default | Purpose |
|---|
GASFEE_API_BASE | https://api.gasfeepredictor.com | Override the API base (e.g. for self-hosting). |
| Tool | What it answers | Hosted | npm |
|---|
get_current_gas | "What's the Ethereum gas fee right now?" β low/avg/high Gwei, ETH price, send-now-vs-wait. | β
| β
|
get_l2_gas | "Cheapest L2 right now?" β live Arbitrum / Base / Optimism / Polygon fees. | β
| β
|
get_eth_price | Current ETH/USD and 24h change. | β
| β
|
best_time_to_transact | Send now or wait? Next cheaper window + expected savings. | β
| β
|
estimate_transaction_cost | USD cost of an ETH transfer / USDC transfer / Uniswap swap / NFT mint (or custom gas), per tier. | β
| β
|
get_gas_forecast | Forward-looking hourly gas forecast, up to 24h ahead. | β
| β |
get_gas_history | Recent historical mainnet gas over a chosen window, with min/max/avg. | β
| β |
Notes
- Read-only and unauthenticated β it only reads public gas data.
- Upstream data refreshes every ~30β60s.
- Served from
api.gasfeepredictor.com, not the apex, so automated clients are not
challenged by the CDN's bot protection.
- MIT licensed.
Changelog
1.1.0 β get_current_gas and estimate_transaction_cost now fall back to
/api/eth-price when the dashboard payload returns ethPrice: null (upstream price
cooldown). Previously they rendered ETH β $undefined or failed outright while the
price endpoint was serving fine.