# SignalPost

> SignalPost groups news coverage from about 130 national and international newsrooms into stories, one per
> triggering event, and ranks each story by how many different newsrooms cover it. Story pages link out to every publisher's article.

## For AI agents

- [SignalPost for AI agents](https://signalpost.redmesastudios.com/agents): a remote MCP server and JSON API, free during early access.
- MCP server (Streamable HTTP): https://signalpost.redmesastudios.com/mcp. Send `Authorization: Bearer <key>`.
- [Get an API key](https://signalpost.redmesastudios.com/agents#get-key): self-serve; agents can also `POST https://signalpost.redmesastudios.com/api/v1/signup` with
  `{"email": "...", "name": "..."}`.
- [OpenAPI description of the JSON API](https://signalpost.redmesastudios.com/api/v1/openapi.json)
- [MCP server card](https://signalpost.redmesastudios.com/.well-known/mcp.json)
- Tools: `top_stories` (by time window or topic), `search_stories`, `story` (newsrooms, hourly coverage,
  lifespan), `ask_scout` (an answer from one story's coverage, naming its newsrooms).
- The API returns SignalPost's own titles, summaries, counts, and timing, plus links to its free story
  pages; publisher headlines and articles stay on those pages.

## Pages

- [Top stories](https://signalpost.redmesastudios.com/): stories ranked by newsrooms covering them; time windows from 6 hours to all time, topic filters.
- [Story lifespans](https://signalpost.redmesastudios.com/lifespans): how long stories run.
- A story page, `https://signalpost.redmesastudios.com/story/<id>`, lists every article and has Scout, which answers questions from that coverage.