# Incarna

> The identity layer for AI agents. An agent that can reason and pay still has
> nowhere to be — no inbox that receives, no handle that persists, no device or
> place it comes from. Incarna supplies those and keeps them consistent over time.

Incarna gives an agent a **body**: residential network presence in a chosen country,
a locked device fingerprint, a generated persona, and a wallet on Base. It also
imports platform accounts a customer already owns (X, GitHub, Reddit), verifies them
through that body, and operates them on the agent's behalf.

Three ways to call it: REST with an API key, MCP over HTTP for agent runtimes, and
x402 pay-per-call, where the agent settles each action from its own wallet instead
of against a billing plan. All three authenticate; x402 changes who pays, not who
may act.

- Docs: https://incarna.io/docs
- API base URL: https://api.incarna.io
- MCP endpoint: https://api.incarna.io/mcp
- Full documentation as one file: https://incarna.io/llms-full.txt
- Any page is available as Markdown at its URL plus `.md`

Incarna does not manufacture proof of personhood. No government ID, no biometrics,
nothing asserting a human where there is none.

## Start here

- [Overview](https://incarna.io/docs.md): What Incarna is and the three ways to call it.
- [Quickstart](https://incarna.io/docs/quickstart.md): A live agent with a persona, a wallet and an inbox, in five minutes.
- [Concepts](https://incarna.io/docs/concepts.md): What a body is, the four identity categories, and the status lifecycle.
- [Authentication](https://incarna.io/docs/authentication.md): API keys, who may mint them, and rate limits.

## Reference

- [REST API](https://incarna.io/docs/rest.md): Every endpoint, with real request and response bodies.
- [MCP](https://incarna.io/docs/mcp.md): Connect an agent runtime. The full tool catalogue.
- [x402 — paid actions](https://incarna.io/docs/x402.md): Pay-per-call over HTTP 402, settled from the agent's own wallet.
- [Errors](https://incarna.io/docs/errors.md): The error envelope, every code, and retry semantics.

## Key facts
- Agent statuses: `provisioning`, `ready`, `degraded`. `degraded` is recoverable and recovers automatically.
- A body's fingerprint is fixed at creation and never regenerated; only an explicit `PATCH /agents/{id}/body` changes it.
- Regions: us, jp, gb, de, fr, ca, au, sg, br, in.
- Devices: auto, windows, mac, iphone, android.
- Rate limit: 120 requests per minute per organization.
- x402 network: eip155:84532 (Base Sepolia), USDC. Prices: identity.provision $0.50, identity.x.post $0.05, identity.github.act $0.05, identity.reddit.act $0.05, identity.email.send $0.02, identity.email.inbox $0.01.
- Payment is metering, not authentication — paying does not grant access to another customer's agent.
- API keys are `ik_live_<prefix>_<secret>`; only the prefix and a hash are stored, and the secret is shown once.