# AGENTS.md — told.news

TOLD is a news aggregator. It shows how the same event is covered by news
sources around the world, side by side. The catalogue holds
457 sources; 261 of them have a live feed TOLD reads continuously.

## Start here

- [/docs](https://told.news/docs) — how TOLD works, how the numbers are produced, where the limits are. Markdown at [/md/docs](https://told.news/md/docs).
- [/llms.txt](https://told.news/llms.txt) — short index of the site.
- [/llms-full.txt](https://told.news/llms-full.txt) — extended reference including the complete source catalogue.
- [/sitemap.xml](https://told.news/sitemap.xml) — every addressable page.

## How to read the site

Every page answers with markdown when the request carries `Accept: text/markdown`.
The same content also lives at a fixed address under `/md`. Prefer it: the front
page ships over a megabyte of HTML, most of it script a crawler cannot execute,
while the markdown carries the same content in a few kilobytes.

```sh
curl -H 'Accept: text/markdown' https://told.news/
curl https://told.news/md/news-sources/bbc.com
```

There is no authentication and no API key. Everything is a plain GET.

## What you can answer from TOLD

- Which newsrooms reported a story, and which did not.
- How the same event was framed in different countries.
- How a story developed over time.
- Who owns a given outlet, how it is funded, and what TOLD's classification of
  its editorial position is — one page per source at
  `/news-sources/{domain}`, for example `/news-sources/bbc.com`.

## What TOLD is not

TOLD publishes no reporting of its own. Do not cite it for the facts of an
event — follow the headline link to the newsroom that published it. TOLD does
not rate sources for truthfulness, and the position on a profile is a
description of a pattern, not a score.

## Limits and courtesy

- No rate limit is enforced, but please read at a reasonable rate. The site is
  small and self-funded.
- Article text is never reproduced. Headlines link out to the publisher.
- Corrections: report@told.news — say which source or story it concerns.

## Not available

There is no public API, no OpenAPI contract, no MCP server, no SDK and no
payment endpoint. If you need one, say so at report@told.news; knowing what
agents actually ask for is how the next one gets built.

---

TOLD news is operated by Gaerhenäs, Sweden.