# AgentDataAPI

> Grid power prices and carbon, open sensors, weather alerts and forecasts, news and social signals.

- name: com.agentdataapi/agentdata
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 85/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.agentdataapi%2Fagentdata
- tools: https://api.protogrid.dev/v1/servers/com.agentdataapi%2Fagentdata/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "agentdata": {
      "type": "http",
      "url": "https://agentdataapi.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

- hygiene: 80
- liveness: 97
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-92% +updated-0d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 94 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 41 of 41 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 1 of 41 tools declare all four hints; missing: sensors_water_gauge (destructiveHint, idempotentHint); grid_price (destructiveHint, idempotentHint); grid_cheapest_window (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 5,600 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`, `stability.new_links`: tool history recorded for 3 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 41, about 5,600 tokens to load them all
- tool set hash: e3cb2ff8027643cce704b5c8ad3e97c3
- tools last changed: 2026-11-14T04:17:32.173Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.agentdataapi/agentdata.svg)](https://protogrid.dev/servers/com.agentdataapi/agentdata)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-14 `social_history` changed (inputSchema)
- 2026-11-14 `trending_github_repos` changed (inputSchema)
- 2026-11-14 `hot_discussions` changed (inputSchema)
- 2026-11-14 `social_top_mentions` changed (inputSchema)
- 2026-11-14 `social_trending_links` changed (inputSchema)
- 2026-11-14 `social_trending_topics` changed (inputSchema)
- 2026-11-14 `news_top_stories` changed (inputSchema)
- 2026-11-14 `news_trending_topics` changed (inputSchema)
- 2026-11-14 `news_trending_people` changed (inputSchema)
- 2026-11-14 `news_sentiment_history` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/com.agentdataapi%2Fagentdata/changes

## Remotes

- https://agentdataapi.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.9166667)

## Packages

_none_

## Tools (41)

- `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_carbon`: GB grid carbon intensity in gCO2/kWh: actual and forecast now, the next 6 hours, and the regional generation mix.
- `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_day_ahead`: Day-ahead (EU) or pre-dispatch (NEM) prices per interval for a local day, with min, max, average and negative intervals.
- `grid_generation`: Latest generation mix for a region: MW per fuel, total and renewables share (basis points).
- `grid_load`: Latest grid demand for a region in MW.
- `grid_price`: Latest settled wholesale electricity price for a region (micro units of local currency, USD conversion, demand, negative-price flag).
- `grid_price_history`: Settled prices for the last 7 days (Pro), optionally averaged per 30 or 60 minutes.
- `grid_regions`: Every power market region we serve: code, market, timezone, currency, source and price cadence.
- `hot_discussions`: Hot discussions merged from Hacker News, Lobsters and Lemmy: title, link, discussion URL, score, comments, heat.
- `list_capabilities`: What this server offers across energy, sensors, weather, news and social: endpoints, prices and the first calls to make. No key needed.
- `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_sentiment_history`: Mentions and tone per window or per day for an entity (Pro), newest first.
- `news_ticker_score`: News score for a ticker: how unusual the coverage volume is and how its tone compares with normal.
- `news_top_stories`: The most-covered stories in the window (title, link, publisher, tone), never article text.
- `news_trending`: Entities with the most unusual news volume in the window, ranked by novelty against their baseline.
- `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.
- `petroleum_weekly`: Latest EIA weekly US petroleum inventory figure with the previous week and the change.
- `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_quakes`: Earthquakes in the last N hours from USGS, optionally above a magnitude and within a radius of a point.
- `sensors_stations_near`: Stations of every open sensor network near a point, nearest first, with distance and parameters.
- `sensors_tide_predictions`: Predicted high and low tides for a day at a NOAA tide station.
- `sensors_tides`: Latest observed water level (metres MLLW) at a NOAA tide station with the next high and low.
- `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).
- `social_history`: Stored hourly or daily history for a hashtag, a symbol (mentions and tone) or a GitHub repo (stars), newest first (Pro).
- `social_network_stats`: Activity per network: Bluesky and Nostr posts per hour, fediverse size (FediDB), Hacker News items per hour.
- `social_symbol_mentions`: Social volume and tone for one ticker or coin: mentions per network against its baseline, spike, trend and discussions naming it.
- `social_topic_trend`: One hashtag across networks: mentions per network, expected count, spike, trend, first seen and the last 24 hours by hour.
- `social_top_mentions`: Stocks and crypto assets ranked by social attention: mentions against a 30-day baseline, spike, lexicon tone, discussions.
- `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_trending_topics`: Trending hashtags across Bluesky, Mastodon and Nostr (mentions x spike against each tag's baseline), plus Bluesky's own trends list.
- `trending_github_repos`: GitHub repositories gaining the most stars in the window, with language, topics and discussions linking them.
- `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.