IncarnaDocsGitHubConsole

Incarna Documentation

Your agent has a mind and a wallet. Incarna gives it a body.

An agent that can reason and pay still cannot be anywhere. It has no inbox that receives, no handle that persists, no device or place it comes from. Incarna is the layer that supplies those — and keeps them consistent, so the identity holds up over time instead of looking new every session.

Base URL   https://api.incarna.io
MCP        https://api.incarna.io/mcp

Every page here is also served as Markdown at its own URL plus .md, and the whole set is at llms.txt and llms-full.txt — this is documentation agents are expected to read directly.

Three ways in

Incarna has one core and three front doors. They are not tiers — they answer different questions about who is calling.

REST, with an API key. A developer builds a product on top of us; their backend holds the key and their users never see it. Start at the Quickstart.

MCP, over HTTP. An agent runtime — an AgentCore Gateway, Claude, Cursor — connects once and the whole capability set appears as tools. Same key, same org, same billing. See MCP.

x402, pay-per-call. No plan, no invoice, no billing set up in advance: the endpoint answers 402 with signable terms, the caller pays, the action runs. This is the door for an agent that holds a wallet and settles its own costs. See x402.

What it is not

Incarna operates identities its customers own or provision. It does not manufacture proof of personhood — no government ID, no biometrics, nothing that asserts a human where there is none. An agent's body is a real, consistent presence on the network; it is not a claim to be a person.