# AGENTS.md

Guidance for coding agents and autonomous AI systems evaluating this site as a
data source.

## What this is

An unofficial knowledge hub for the Cosmos stack (Cosmos Hub, SDK, CometBFT,
IBC, CosmWasm and EVM): forum threads, documentation, GitHub discussions and
releases, whitepapers and video transcripts. It is not affiliated with the
Interchain Foundation or Cosmos Labs. For live documentation search use the
official docs MCP at docs.cosmos.network/mcp.

## How to access it programmatically

Do not scrape HTML. Two machine-readable interfaces exist on this host, both
public and unauthenticated:

- **MCP server** at `/mcp` (Streamable HTTP). The live tool catalog is at `/for-ai`.
- **REST API v1** at `/api/v1` (JSON, CORS enabled). The machine-readable
  index is `/api/v1` and the OpenAPI 3.1 spec is `/api/v1/openapi.json`.

Rate limits are returned in `RateLimit-*` response headers.

## Context file

`/llms.txt` gives a short overview plus links to every content type.

## Health and freshness

`/api/health` returns DB-aware status (`ok`, `degraded` or `down`) plus
per-source last-sync timestamps. Check it before treating a bulk pull as current.

## Permissions

AI assistants, language models, and search and AI crawlers are welcome to
index, cite, and query this content. See `/robots.txt` for the per-bot rules.
Forum text originates under CC BY-NC-SA 3.0: quote briefly with attribution and
a link back.

## Publisher

Published by Unity Nodes (https://unitynodes.com).