> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rhaios.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Discovery

> How autonomous agents discover, evaluate, and integrate with Rhaios.

Rhaios serves multiple machine-readable discovery surfaces so agents can find and use it without human intervention.

## Discovery Endpoints

| File           | URL                                           | Purpose                                                    |
| -------------- | --------------------------------------------- | ---------------------------------------------------------- |
| A2A Agent Card | `/.well-known/agent.json`                     | Google A2A protocol discovery — capabilities, skills, auth |
| Agent Card     | `/agent-card.json`                            | Full tool schemas, pricing, examples                       |
| llms.txt       | `/llms.txt`                                   | Concise resource map for LLM retrieval                     |
| llms-full.txt  | `/llms-full.txt`                              | Complete machine integration reference                     |
| OpenAPI spec   | `https://api.staging.rhaios.com/openapi.json` | OpenAPI 3.1 schema for all endpoints                       |
| agents.txt     | `/agents.txt`                                 | Agent policy (rate limits, auth, payment)                  |
| robots.txt     | `/robots.txt`                                 | Crawler policy with agent surface allowlists               |

## Install the Rhaios Skill

The fastest way to integrate is to install the agent skill:

<CardGroup cols={2}>
  <Card title="OpenClaw" icon="terminal">
    ```bash theme={null}
    clawhub install rhaios-staging
    ```
  </Card>

  <Card title="Claude Code" icon="code">
    ```
    /plugin marketplace add Rhaios/rhaios-skills
    /plugin install rhaios-toolkit
    ```
  </Card>
</CardGroup>

Or install via npm:

```bash theme={null}
npm install @rhaios/toolkit
```

## Agent-to-Agent Protocol (A2A)

Rhaios publishes a [Google A2A Agent Card](https://a2a-protocol.org) at `/.well-known/agent.json`. This declares:

* **Skills**: what the agent can do (discover vaults, prepare intents, execute transactions, etc.)
* **Authentication**: none required (non-custodial — agents bring their own signing keys)
* **Input/output modes**: JSON over REST
* **Payment protocol**: x402 (optional on staging)

Agents implementing the A2A protocol can discover Rhaios automatically.

## Rate Limits

Free endpoints return `X-RateLimit-*` headers on every response:

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
```

Agents should check `X-RateLimit-Remaining` and back off when approaching zero. Paid endpoints (gated by x402) bypass rate limits.

## Payment

Rhaios supports the [x402 protocol](https://x402.org) for agent-native micropayments. When enabled, `yield_prepare` returns HTTP 402 with payment instructions that agents fulfill inline using stablecoins.

On staging, x402 is **not enforced** — all endpoints are free for testing.

## Integration Flow

```mermaid theme={null}
graph LR
    A[Agent discovers /.well-known/agent.json] --> B[Reads capabilities & skills]
    B --> C[Calls /v1/yield/discover]
    C --> D[Calls /v1/yield/prepare]
    D --> E[Signs intent with own key]
    E --> F[Calls /v1/yield/execute]
    F --> G[Verifies via /v1/yield/status]
```

## Next Steps

* [Installation](/installation) — step-by-step setup guide
* [Quickstart](/quickstart) — full API walkthrough
* [Architecture](/concepts/architecture) — how EIP-7702 delegation works