Gas Agent

Gas Agent

By samarabdelhameed GitHub

-

gas-agent gas-price
Overview

What is Gas Agent?

Gas Agent is an AI-ready gas price monitoring dashboard that allows users to track real-time gas prices across Ethereum, BNB, and Polygon networks, and provides smart recommendations based on natural language queries.

How to use Gas Agent?

To use Gas Agent, clone the repository, install the dependencies, build the Tailwind CSS, and start the server. Access the dashboard via your browser at http://localhost:3000.

Key features of Gas Agent?

  • Multi-network support for Ethereum, BNB, and Polygon
  • Live gas price API for each network
  • Interactive dashboard with charts for gas fees
  • Natural Language Processing (NLP) agent for user queries
  • Real-time alerts for low gas fees
  • CSV export of gas history
  • Stylish dark-themed UI using Tailwind CSS

Use cases of Gas Agent?

  1. Monitoring gas prices for optimal transaction timing.
  2. Comparing gas fees across different blockchain networks.
  3. Receiving alerts for favorable gas prices.

FAQ from Gas Agent?

  • Can Gas Agent monitor gas prices for all networks?

Yes! Gas Agent supports Ethereum, BNB, and Polygon networks.

  • Is there a mobile version of Gas Agent?

Currently, the dashboard is optimized for desktop use, but it can be accessed on mobile browsers.

  • How accurate are the gas price predictions?

The predictions are based on real-time data and historical trends, providing reliable insights.

Content

🚀 MCP Gas Price Agent Dashboard 🛰️

An MCP-compatible AI-ready gas price agent built with Node.js, Express, and TailwindCSS.
This dashboard enables users to monitor real-time gas prices on Ethereum, BNB, and Polygon, ask natural language questions, and receive smart recommendations on when to transact.


🧠 What This Project Delivers

From initial goals to full implementation, here's what has been achieved:

  • Multi-network support for Ethereum, BNB, and Polygon
  • Live gas price API for each network
  • Dashboard with interactive charts (Max Fee & Priority Fee over time)
  • Natural Language Processing Agent to interpret human questions like:
    • “Is now a good time?”
    • “What’s the max gas fee?”
    • “Compare between networks”
  • Real-time alerts when gas fee is extremely low
  • Export to CSV of gas history
  • Auto-refreshing UI (adjustable refresh rate)
  • Stylish dark-themed UI using Tailwind CSS
  • MCP-compatible plugin (mcp.json) so it can be connected directly to Claude or GPT

🔧 Features

EndpointDescription
/api/gas-priceReturns live gas prices for selected network
/api/nlp-agentReturns intelligent replies to natural questions
/dashboardDisplays live gas charts, NLP, export tools, etc
/Tailwind-based landing page
mcp.jsonPlugin schema for AI agents

📸 Preview

Dashboard Screenshot
(Shows live chart, network selector, NLP agent input, CSV export)


📦 Tech Stack

  • Node.js + Express
  • TailwindCSS
  • Chart.js
  • Blocknative, BscScan, PolygonScan APIs
  • MCP Plugin (Claude/GPT ready)

🚀 How to Run Locally

  1. Install dependencies
npm install

2. **Build Tailwind CSS**

```bash
npm run build:css
```

3. **Start server**

```bash
npm start
```

4. **Visit the app**
   Open your browser at:
   [http://localhost:3000](http://localhost:3000)

---

## 🤖 Ask Anything!

The AI Agent supports questions like:

- "Is now a good time?"
- "What’s the gas fee?"
- "What's the average gas price?"
- "What’s the highest gas today?"
- "Which network is cheaper?"
- "Is BNB cheaper than Ethereum?"

---

## 🔌 AI Plugin (MCP)

You can connect this project directly to Claude/GPT via the `mcp.json` file.
Example usage:

```json
{
  "schema_version": "v1",
  "name_for_model": "mcp_gas_agent",
  ...
}
```

---

## 📁 Folder Structure

```
📦 MCP-Gas-Agent
├── public/
│   ├── index.html
│   ├── dashboard.html
│   └── styles.css
├── server.js
├── mcp.json
├── tailwind.config.js
├── package.json
└── README.md
```

---

## 📝 License

MIT © 2025 - MCP Gas Price Agent Team

---

No tools information available.
No content found.