# Catena Docs

> Catena is a governance and banking platform for AI agents. Policies govern what each agent can do. People approve the actions that policies require.

Every page is available as Markdown: add `.md` to its URL. The home page is https://docs.catena.com/index.md. All pages in one file: https://docs.catena.com/llms-full.txt. After you install the CLI, `catena guide` prints the operating guide for the installed version; follow it where it differs from these pages.

## Documentation

### Get started

- [Catena documentation](https://docs.catena.com/index.md): Catena is a governance and banking platform for AI agents. Policies decide what each agent can do, and people approve the actions that policies require.
- [Quickstart](https://docs.catena.com/quickstart.md): Give your agent one prompt, approve it into your sandbox, and have it make a test payment that you'll see in the console.
- [How Catena works](https://docs.catena.com/concepts.md): Definitions of organizations, agents, policies, intents, approvals, accounts, and counterparties, and how each of them relates to the others.
- [Sandbox](https://docs.catena.com/sandbox.md): A separate organization that runs on test money, where you can connect an agent, write a policy, and test payments before you move real money.
- [Test in the sandbox](https://docs.catena.com/test-in-sandbox.md): The policy rules and requests that produce each payment outcome on test money, and what your agent will see for each one.

### Connect an agent

- [Connect an agent](https://docs.catena.com/connect.md): Connect an agent to Catena with the CLI, an MCP connector, or a secret key, depending on where the agent runs.
- [Link with the CLI](https://docs.catena.com/connect/cli.md): Link a new or existing agent that runs in a terminal, on your own machine or a headless host, with catena link.
- [Link with the MCP](https://docs.catena.com/connect/mcp.md): Apps with custom connectors, such as Claude and ChatGPT, can act as a Catena agent through our remote MCP server.
- [Link with secret keys](https://docs.catena.com/connect/secret-keys.md): A secret key lets an agent act in Catena from hosts where catena link cannot store a credential, such as CI jobs, cloud sandboxes, and deployed services.
- [Credential storage](https://docs.catena.com/connect/credentials.md): Where the CLI keeps an agent's signing key on each kind of host, and which credential mode to use when there's no keychain.

### Configure

- [Create and fund accounts](https://docs.catena.com/accounts.md): Open an account, fund it with stablecoins or a bank transfer, read its balances, and send or transfer from it in live and sandbox organizations.
- [Set policies](https://docs.catena.com/policies.md): Decide what each agent can do with its policy, from the accounts it can read and the counterparties it can pay to its spending rules and temporary overrides.
- [Manage counterparties and vendors](https://docs.catena.com/counterparties.md): Add the people and businesses you pay, request their payment details, and find the rail ID your agent sends to.
- [Team and roles](https://docs.catena.com/team.md): The three roles in a Catena organization, what each one can do, and how operators and admins divide the work.
- [Get USD access](https://docs.catena.com/fiat-access.md): Verify your organization as a business or as an individual so that it can send and receive USD by ACH and wires.

### Operate

- [Handle approvals](https://docs.catena.com/approvals.md): Learn what goes to the approvals queue, who can approve, when requests expire, and what happens between an approval and a completed payment.
- [Manage notifications](https://docs.catena.com/notifications.md): Choose how Catena notifies you about transactions, approval requests, and agents, by email or Slack direct message.
- [Intents and retries](https://docs.catena.com/intents.md): Learn how an intent moves through its statuses and resolutions, which fields explain its result, and how to retry safely with idempotency keys.
- [Analytics and reporting](https://docs.catena.com/reporting.md): Review your agents' activity in the console, export reports of agent payments and exceptions as CSV, and read transactions from the CLI.
- [On- and off-ramp stablecoins](https://docs.catena.com/on-and-off-ramps.md): Receive USD by bank transfer as USDC, and pay bank accounts in USD from your account's USDC.
- [Use x402 and MPP](https://docs.catena.com/x402-and-mpp.md): Let your agent pay HTTP 402 endpoints in USDC with x402 or the Machine Payments Protocol, under the same policy as any other payment.
- [Send wires and ACH](https://docs.catena.com/wires-and-ach.md): Pay US bank accounts by ACH or wires, with the bank details, fees, timing, memos, and statuses for each.

### Resources

- [Troubleshooting](https://docs.catena.com/troubleshooting.md): The errors you may run into while linking, signing, and sending payments, with the cause of each and what to do about it.
- [Security](https://docs.catena.com/security.md): How Catena handles custody of your funds, agent signing keys, policy enforcement, revocation, and vulnerability reports.
- [Changelog](https://docs.catena.com/changelog.md): The changes to the Catena console, API, CLI, and SDK that you'll notice, with the newest first.

## Solutions

- [Solutions](https://docs.catena.com/solutions.md): Step-by-step recipes for common agent tasks, and setup guides for the tools your agents run in.

### Recipes

- [Pay a vendor invoice](https://docs.catena.com/recipes/pay-a-vendor-invoice.md): Your agent pays a vendor invoice by ACH, and any invoice at or above your approval threshold will wait for an admin.
- [Pay for an API call](https://docs.catena.com/recipes/pay-for-an-api-call.md): Your agent pays an x402 endpoint in USDC from a wallet account, and it won't pay more than the price ceiling you set.
- [Raise a limit for one task](https://docs.catena.com/recipes/raise-a-limit.md): When a single limit blocks a task, your agent can ask an admin to raise it for a while, and then finish the task once the admin approves.

### Integrations

- [Claude Code](https://docs.catena.com/integrations/claude-code.md): Connect Claude Code to Catena with the CLI, and it will read accounts and make payments under the agent's policy.
- [Codex](https://docs.catena.com/integrations/codex.md): Connect the Codex CLI to Catena with catena link, or connect Codex cloud tasks with a secret key.
- [Claude (desktop and web)](https://docs.catena.com/integrations/claude-app.md): Add Catena to the Claude app as a custom connector, and Claude will read accounts and submit payments for an admin to approve.
- [ChatGPT](https://docs.catena.com/integrations/chatgpt.md): Add Catena to ChatGPT as a custom plugin in developer mode, and ChatGPT will read accounts and submit payments for an admin to approve.
- [Cloud coding agents](https://docs.catena.com/integrations/cloud-agents.md): Connect Claude, Codex, and Cursor cloud agents and Copilot's coding agent to Catena with a secret key that the platform injects into each sandbox.
- [Meta Muse](https://docs.catena.com/integrations/meta-muse.md): Connect a Meta Muse agent to Catena with the CLI on its Linux computer, where the CLI will store the key without a keychain.

## API & SDK reference

### Agent API

- [Agent API](https://docs.catena.com/api.md): The base URL, request signing, and conventions of the agent API, the signed HTTP API that the CLI and the SDK call.

### Agent and policy

- [Get the agent](https://docs.catena.com/api/get-agent.md): Resolve the agent behind the session token.
- [Get the policy](https://docs.catena.com/api/get-policy.md): Get the policy assigned to the agent.
- [Get setup state](https://docs.catena.com/api/get-setup-state.md): Report the agent's onboarding readiness and blocking steps.
- [List networks](https://docs.catena.com/api/list-networks.md): List the onchain networks enabled for this environment.
- [Send feedback](https://docs.catena.com/api/send-feedback.md): Submit free-form agent feedback.
- [Unlink the agent](https://docs.catena.com/api/unlink-agent.md): Unlink the current agent client context.

### Accounts

- [List accounts](https://docs.catena.com/api/list-accounts.md): List accounts the agent can act on under its policy.
- [Get a balance](https://docs.catena.com/api/get-balance.md): Get a policy-gated account balance.
- [List transactions](https://docs.catena.com/api/list-transactions.md): Get a policy-gated account transaction history.
- [Get a deposit address](https://docs.catena.com/api/get-deposit-address.md): Get a policy-gated account deposit address.

### Counterparties

- [List counterparties](https://docs.catena.com/api/list-counterparties.md): List counterparties visible to the agent.

### Intents

- [Create an intent](https://docs.catena.com/api/create-intent.md): Create an intent for a governed action.
- [List intents](https://docs.catena.com/api/list-intents.md): List intents created by the authenticated agent.
- [Get an intent](https://docs.catena.com/api/get-intent.md): Get an intent by id.
- [Cancel an intent](https://docs.catena.com/api/cancel-intent.md): Cancel an intent before execution starts.
- [Report a settlement](https://docs.catena.com/api/report-settlement.md): Report the facilitator's settlement transaction for a completed x402 payment.

### SDK and CLI

- [SDK reference](https://docs.catena.com/sdk.md): Setup, methods, intent actions, errors, and client options for @catena/sdk, the TypeScript client for the agent API.
- [CLI reference](https://docs.catena.com/cli.md): The public commands in @catena/cli 0.19.0, generated from the CLI's help text.

## Machine-readable

- [Agent API OpenAPI document](https://api.catena.com/v1/agent-api/openapi.json): The contract the API reference is generated from
- [Service manifest](https://api.catena.com/.well-known/catena.json): API, MCP, CLI, and SDK locations