io.github.higherbeing/gasfeepredictor-mcp
Live Ethereum and L2 gas fees for AI agents: current gas, cheapest L2, ETH price, cost estimates.
Open source Open in the app JSON README (API)
About
Live Ethereum and L2 gas fees for AI agents: current gas, cheapest L2, ETH price, cost estimates.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- higherbeing
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-07-02T20:48:37Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:00:07
- Updated
- 2026-08-29 04:00:07
- Origin id
io.github.higherbeing/gasfeepredictor-mcp
README
# Gas Fee Predictor — MCP Server
Live Ethereum + Layer-2 gas-fee data for AI agents, via the
[Model Context Protocol](https://modelcontextprotocol.io). Works with
**Claude Desktop, OpenClaw, Cursor, Cline**, and any other MCP client.
It's a thin, read-only wrapper over the free public API at
`https://api.gasfeepredictor.com` (no key, no auth). Every answer includes a
citation back to [gasfeepredictor.com](https://gasfeepredictor.com).
## Tools
| Tool | What it answers |
|---|---|
| `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. |
## Install
With npm (once published):
```bash
npx gasfeepredictor-mcp
```
Or from source:
```bash
git clone https://github.com/higherbeing/gasfeepredictor-mcp
cd gasfeepredictor-mcp
npm install
npm start
```
Requires Node ≥ 18.
## Configure your client
### Claude Desktop
Add to `claude_desktop_config.json` (macOS:
`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"gasfeepredictor": {
"command": "npx",
"args": ["-y", "gasfeepredictor-mcp"]
}
}
}
```
(Or use `"command": "node", "args": ["/absolute/path/to/gasfeepredictor-mcp/index.mjs"]` to run from source.)
Restart Claude Desktop, then ask: *"What's the Ethereum gas fee right now, and is it cheaper on an L2?"*
### OpenClaw / Cursor / Cline
Any MCP-capable client uses the same shape — register a stdio server with
`command: npx, args: ["-y", "gasfeepredictor-mcp"]` (or `node` + the path to
`index.mjs`) in that client's MCP servers config.
## Config
| Env var | Default | Purpose |
|---|---|---|
| `GASFEE_API_BASE` | `https://api.gasfeepredictor.com` | Override the API base. |
## Notes
- Read-only and unauthenticated — it only reads public gas data.
- Data refreshes ~every 30–60s upstream.
- MIT licensed.