---
title: Atlas News Intelligence
description: Read-only, evidence-backed global news intelligence documentation.
canonical: https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/
last-updated: 2026-08-27
---

# Atlas News Intelligence

Atlas is a read-only global news intelligence service over current, evidence-backed records. It maps event locations, keeps publisher origin and each outlet's evidence-backed primary editorial market separate, clusters reports about the same event, and exposes raw plus source-normalized prominence.

## Public browser

- [Interactive explorer](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/)
- Default window: rolling 24 hours
- No product stub data: unavailable current evidence produces an explicit degraded or unavailable state

## Public REST API

- [Service index](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/api)
- [OpenAPI 3.1 description](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/openapi.json)
- [Public access and authentication statement](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/auth.md)
- [Versioning and deprecation policy](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/api/versioning)
- [Health](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/health)
- [Intelligence snapshot](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/api/v1/intelligence?window=24h&prominence=normalized)
- [Story list](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/api/v1/stories?metric=normalized&limit=20)
- Story detail: `https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/api/v1/stories/{cluster_id}`

The public read API requires no authentication. Atlas does not publish mutation, account, payment, or credential-management operations.

## MCP

- Endpoint: `https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/mcp`
- [Server card](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/.well-known/mcp/server-card.json)
- Read-only tools: `atlas.query_dominant_stories`, `atlas.explain_story_cluster`, and `atlas.pipeline_health`.

## A2A

- [Agent Card](https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/.well-known/agent-card.json)
- JSON-RPC 2.0 endpoint: `https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/a2a` using the A2A v1 `SendMessage` method.
- Legacy compatibility: `message/send` accepts the official v0.3 lowercase `user` role and one `{kind:"text",text}` or `{kind:"data",data}` part. It returns a direct v0.3 `kind:"message"` result with lowercase `agent` role.
- HTTP+JSON compatibility: `https://atlas-news-intelligence-api.atlas-news-surface.workers.dev/a2a/message:send`.
- Text parts on either JSON-RPC method must contain strict JSON for one supported read operation; free-form text is rejected.
- Supported operations: `query_stories`, `explain_story`, and `pipeline_health`.

## Truth and security boundaries

- Event location is never inferred from publisher headquarters.
- Each observed editorial market is one evidence-backed primary outlet market; unknown assignments remain explicit.
- Event location and publisher origin never substitute for editorial market.
- Every story member retains a source URL and cluster-membership evidence.
- Unknown or stale data remains visible; it is never replaced with fabricated news.
- Machine-readable surfaces describe only deployed public read capabilities.
- Responses advertise a best-effort per-Worker-instance public-read limit. A 429 includes `Retry-After`; clients should honor it.