Quickstart

Verify an agent and gate a paid tool in a few minutes.

There are two ways to integrate A-Identity. Use the SDK inside your own agent, or connect the MCP server so any agent can reach you. Most teams start with the MCP server because it needs no code in the agent itself.

Use The SDK

Drop identity and payments into your agent in a few lines.

Run The MCP Server

Expose verify, reputation, and capabilities to any MCP client.

Run The Server Locally

cd mcp
npm install
npm run build
npm run start        # stdio
npm run start:http   # Streamable HTTP on http://localhost:3399

Verify Your First Agent

1. Connect

   Point your MCP client at the server, or import the SDK.

2. Resolve

   Call resolve_agent with an id, owner address, or domain.

3. Score

   Call get_reputation to read the deterministic score before you transact.

const agent = await client.callTool({
  name: "resolve_agent",
  arguments: { query: "eip155:5042002:8004/849980" },
})

Anything that moves real value stays human-on-the-loop. The read-only tools here never touch keys or funds.