# TheAgent

> Independent Brazilian publication about AI agents at work.

## When to use

Use this index to discover and cite public TheAgent reporting or to choose a compact Markdown representation of a public page. Do not use it to access member-only material, operate a member account or replace the source URL in an attribution.

## Public discovery

- [Home](https://theagent.bz/): latest public articles
- [News](https://theagent.bz/noticias/): reporting about AI agents in Brazil
- [Podcast](https://theagent.bz/podcast/): podcast episodes
- [White papers](https://theagent.bz/white-papers/): research library
- [Trust](https://theagent.bz/trust/): canonical trust and correction policy
- [About](https://theagent.bz/sobre/): the publication and founder
- [Privacy Policy](https://theagent.bz/privacidade/): canonical privacy notice
- [Contact](https://theagent.bz/contact/): public editorial and privacy contact channel
- [Developers](https://theagent.bz/developers/): agent and integration guidance, including the error catalogue and the deprecation policy

## Machine-readable endpoints

- [TheAgent expanded LLM index](https://theagent.bz/llms-full.txt): this index plus an enumeration of every public page
- [TheAgent OpenAPI specification](https://theagent.bz/openapi.json): the OpenAPI 3.1 description of every operation below
- [TheAgent API catalog](https://theagent.bz/.well-known/api-catalog): RFC 9727 catalog of the APIs this origin publishes
- [TheAgent public corpus index](https://theagent.bz/v1/index.json): the published corpus as JSON, one entry per public page
- [TheAgent public document API](https://theagent.bz/v1/document?path=/some-page/): one public page as JSON with its Markdown body
- [TheAgent API versions and deprecation policy](https://theagent.bz/v1/versions.json): every published version, its lifecycle status and the notice period
- [TheAgent agent sitemap](https://theagent.bz/sitemap-agents.xml): the agent-facing endpoints, also listed in https://theagent.bz/sitemap.xml

## Agent integrations

- [TheAgent MCP server](https://mcp.theagent.bz): Model Context Protocol server over Streamable HTTP. Authenticated: it answers an OAuth challenge at initialize and exposes no tools to an anonymous caller. Everything public is available without credentials through the endpoints above.

The JSON API under `/v1/` is versioned in the path, answers every failure with an RFC 9457 `application/problem+json` document carrying a machine-readable `code`, and reports its own quota in the `RateLimit` response headers. A withdrawn version is announced with `Deprecation` and `Sunset` headers at least 180 days before it stops answering; every `/v1/` response links the policy with `rel="deprecation"` and `https://theagent.bz/v1/versions.json` states the standing of each version.

## Access and attribution

Public pages support `Accept: text/markdown` and `Accept: application/json`; retain the canonical source URL returned in the document. Content marked for members stays protected and is never included in either representation.