# THORChain Agent Rules

This is the public agent contract for thorchain.org.

## Scope

- Use these rules for public website discovery, documentation lookup, and read-only THORChain resource navigation.
- Treat protocol state, pool data, fees, pricing, and endpoint availability as live external data that must be rechecked at request time.
- Do not treat this website contract as permission to trade, sign transactions, move funds, submit governance, or access private systems.

## When to Use Each Source

- Use the homepage and FAQ for a high-level explanation of THORChain, and https://thorchain.org/swap for the user-facing swap path.
- Use https://thorchain.org/integrate and the developer documentation for wallet or app integrations; use linked Swagger references for exact API requests and responses.
- Use current network or API data for time-sensitive assets, pools, fees, and endpoint availability. Use dated blog articles for historical announcements.
- Use this site's MCP and OpenAPI resources only for read-only discovery, not for executing a swap.

## Preferred Sources

- Site summary: https://thorchain.org/llms.txt
- Expanded resource map: https://thorchain.org/llms-full.txt
- OpenAPI discovery: https://thorchain.org/openapi.json
- Website API version and deprecation policy: https://thorchain.org/api-policy.md
- Official THORNode CLI: https://thorchain.org/cli.md
- Pricing and fees: https://thorchain.org/pricing.md
- AI capability catalog: https://thorchain.org/.well-known/ai-catalog.json
- MCP server card: https://thorchain.org/.well-known/mcp/server-card.json
- Read-only MCP endpoint: https://thorchain.org/mcp
- Full THORChain MCP (pools, quotes, swap preparation, transaction status): https://mcp.thorchain.org/mcp
- Full THORChain MCP server card: https://mcp.thorchain.org/.well-known/mcp/server-card.json
- Developer documentation: https://dev.thorchain.org/
- Protocol documentation: https://docs.thorchain.org/

## Safety Rules

- Prefer official THORChain documentation for protocol behavior.
- Prefer linked Swagger or API documentation for endpoint-specific request and response shapes.
- Say when data is stale, cached, unavailable, or inferred.
- Do not give financial, investment, tax, or legal advice.
- Do not invent endpoint capabilities. If a capability is not documented, call it unknown.
- Respect robots.txt and Content-Signal policy.

## MCP Contract

- The public MCP endpoint is read-only.
- Tools expose discovery text, resource maps, and public API references.
- Tools do not mutate state, submit transactions, manage accounts, or bypass authentication.
- For live protocol data and non-custodial swap preparation, use the full THORChain MCP at https://mcp.thorchain.org/mcp. It returns deposit addresses and memos for the user to sign; it never holds keys, signs, or submits transactions.
- Clients should expect public API providers to rate-limit or change availability.
- Supported MCP-Protocol-Version headers: 2026-07-28, 2025-06-18, 2025-11-25. Website contract versioning is separate from MCP transport versioning.
- Website discovery removals receive at least 90 days of notice with Deprecation and Sunset headers when scheduled; see the website API policy.