# AgentDataAPI

> AgentDataAPI is a freemium MCP server for analytics and data. Power prices, grid carbon, sensors, weather and news signals through one API key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://agentdataapi.com/mcp-server
- **MCP Registry name:** com.agentdataapi/agentdata
- **Categories:** analytics and data, energy and smart home
- **Listing updated:** 2026-11-14

## About

Five data slices sit behind one key: grid and energy, environmental sensors, weather, news and social signals. The grid tools cover prices, day-ahead prices, price history, load, generation, carbon intensity, the cheapest window to run a load, and weekly petroleum figures. Sensor tools cover air quality, water gauges, tides and earthquakes near a point, weather tools cover alerts, current conditions and forecasts, and news and social tools cover sentiment, trending topics and people, top stories, hot discussions and trending GitHub repos.

The endpoint is stateless Streamable HTTP, with the key sent in an X-API-Key header. Two tools need no key: list_capabilities and create_free_api_key. The free key allows 10 requests a minute and 5 a day, a taster; pricing is otherwise per call, with USDC micropayments over x402 or passes for an hour, a day or seven days of Pro. The same feeds are also reachable through RealtimeAPI.ai with 1,000 free calls a month.

## Features

- **Grid and energy:** Prices, load, generation, carbon and cheapest-window lookups.
- **Environmental sensors:** Air quality, river gauges, tides and earthquakes.
- **Weather:** Alerts, current conditions and daily or hourly forecasts.
- **News signals:** Sentiment, trending topics and ticker scores.
- **Social trends:** Open-network trends, hot discussions and GitHub repos.
- **Free key tool:** Mint a free key from inside the server.

## Good for

- Find the cheapest four-hour charging window tonight
- Check whether tomorrow's day-ahead price goes negative
- Get air quality near a warehouse
- Compare news tone for an asset against its baseline
- See which GitHub repos gained stars this week

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentdata https://agentdataapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentdataapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentdata": {
      "url": "https://agentdataapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agentdata": {
      "type": "http",
      "url": "https://agentdataapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agentdata": {
      "serverUrl": "https://agentdataapi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agentdata": {
      "type": "http",
      "url": "https://agentdataapi.com/mcp"
    }
  }
}
```

## Tools

- `list_capabilities`: What this server offers across energy, sensors, weather, news and social: endpoints, prices and the first calls to make. No key needed.
- `create_free_api_key`: Create a FREE AgentDataAPI key (no signup) valid for every slice. Returned once; add it to the server's X-API-Key header.
- `grid_regions`: Every power market region we serve: code, market, timezone, currency, source and price cadence.
- `grid_price`: Latest settled wholesale electricity price for a region (micro units of local currency, USD conversion, demand, negative-price flag).
- `grid_day_ahead`: Day-ahead (EU) or pre-dispatch (NEM) prices per interval for a local day, with min, max, average and negative intervals.
- `grid_price_history`: Settled prices for the last 7 days (Pro), optionally averaged per 30 or 60 minutes.
- `grid_load`: Latest grid demand for a region in MW.
- `grid_generation`: Latest generation mix for a region: MW per fuel, total and renewables share (basis points).
- `grid_cheapest_window`: Cheapest contiguous window of N hours in the next horizon from day-ahead or pre-dispatch prices (GB: greenest window from the carbon forecast).
- `grid_carbon`: GB grid carbon intensity in gCO2/kWh: actual and forecast now, the next 6 hours, and the regional generation mix.
- `petroleum_weekly`: Latest EIA weekly US petroleum inventory figure with the previous week and the change.
- `sensors_stations_near`: Stations of every open sensor network near a point, nearest first, with distance and parameters.
- `sensors_air`: Latest air quality readings and US EPA AQI at one monitor.
- `sensors_air_near`: Air quality monitors near a point with latest readings (PM2.5, PM10, O3, NO2, SO2, CO) and AQI, nearest first.
- `sensors_water_gauge`: Latest river gauge height, discharge and water temperature at a USGS site, with NWS flood stage status.
- `sensors_water_history`: Gauge readings for the last 7 days at a USGS site, newest first (Pro).
- `sensors_tides`: Latest observed water level (metres MLLW) at a NOAA tide station with the next high and low.
- `sensors_tide_predictions`: Predicted high and low tides for a day at a NOAA tide station.
- `sensors_quakes`: Earthquakes in the last N hours from USGS, optionally above a magnitude and within a radius of a point.
- `weather_alerts`: Active weather alerts for a region, severity first. US from the National Weather Service; Australia from the Bureau of Meteorology where licensed.
- `weather_current`: Current conditions at the nearest reporting station (within 150 km) in the United States or Australia.
- `weather_forecast`: Hourly GFS forecast (temperature, humidity, wind, gust, precipitation, cloud) for a point in the contiguous US or Australia.
- `weather_forecast_daily`: Daily forecast summary (min and max temperature, wind, gust, precipitation total) for a point in the contiguous US or Australia.
- `weather_stations_near`: Reporting stations near a point in the United States or Australia, nearest first.
- `news_search_entities`: Search the tracked entities (organisations, tickers, crypto assets, central banks, governments, topics) and get their ids.
- `news_sentiment`: News tone (bps), mentions against the 30-day baseline, volume ratio, novelty and top themes for one entity.
- `news_ticker_score`: News score for a ticker: how unusual the coverage volume is and how its tone compares with normal.
- `news_trending`: Entities with the most unusual news volume in the window, ranked by novelty against their baseline.
- `news_sentiment_history`: Mentions and tone per window or per day for an entity (Pro), newest first.
- `news_trending_people`: Public figures with the biggest attention spike (Wikipedia pageviews and news coverage over their 30-day baseline), by category.
- `news_trending_topics`: Trending topics for a region: top daily searches with headlines, trending Mastodon tags and shared links.
- `news_top_stories`: The most-covered stories in the window (title, link, publisher, tone), never article text.
- `social_trending_topics`: Trending hashtags across Bluesky, Mastodon and Nostr (mentions x spike against each tag's baseline), plus Bluesky's own trends list.
- `social_topic_trend`: One hashtag across networks: mentions per network, expected count, spike, trend, first seen and the last 24 hours by hour.
- `social_trending_links`: The most-shared URLs across networks with titles, shares per network and the Hacker News, Lobsters or Lemmy discussions about them.
- `social_top_mentions`: Stocks and crypto assets ranked by social attention: mentions against a 30-day baseline, spike, lexicon tone, discussions.
- `social_symbol_mentions`: Social volume and tone for one ticker or coin: mentions per network against its baseline, spike, trend and discussions naming it.
- `hot_discussions`: Hot discussions merged from Hacker News, Lobsters and Lemmy: title, link, discussion URL, score, comments, heat.
- `trending_github_repos`: GitHub repositories gaining the most stars in the window, with language, topics and discussions linking them.
- `social_network_stats`: Activity per network: Bluesky and Nostr posts per hour, fediverse size (FediDB), Hacker News items per hour.
- `social_history`: Stored hourly or daily history for a hashtag, a symbol (mentions and tone) or a GitHub repo (stars), newest first (Pro).

## FAQ

### How do I authenticate?

Send the key in an X-API-Key header; list_capabilities and create_free_api_key need none.

### What does the free key allow?

10 requests a minute and 5 a day across every slice.

### How is it priced beyond that?

Per call in USDC over x402, or Pro passes for 1 hour, 1 day or 7 days.

### Is there another free route?

RealtimeAPI.ai offers 1,000 free calls a month over the same five feeds.

### Is AgentDataAPI free?

AgentDataAPI has a free plan, with paid plans for more usage or features.

### How do I add AgentDataAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http agentdata https://agentdataapi.com/mcp

### What are the best alternatives to AgentDataAPI?

The closest alternatives to AgentDataAPI are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/agentdataapi
