Agent Quickstart - XentFi API Documentation

Pick the track that matches what your agent needs to do. Both take a few minutes; see Introduction if you’re not sure which one you need.

MCP Tools (manage a wallet)
x402 (pay per call)

1. Create an Agent and get an Agent API Key

Log into Dashboard

dashboard.xentfi.com

Create an Agent

Agents → New Agent — the identity your AI acts as, separate from your own login.

Attach a Policy

Set per-transaction/daily/weekly/monthly USD limits and an allowed-recipients list. XentFi enforces this server-side on every payment.

Get the Agent API Key

After creating the agent, your Agent API Key is generated and displayed once. Copy and store it securely — you won’t be able to see it again.

2. Connect an MCP client

{
    "mcpServers": {
        "xentfi": {
            "command": "npx",
            "args": [
                "-y",
                "@xentfi/mcp-sdk"
            ],
            "env": {
                "XENTFI_AGENT_API_KEY": "sk_agent_xxx",
            }
        }
    }
}

Restart your client (Claude Desktop shown above) and confirm xentfi appears with 15 tools. See essentials/agent for every other client’s exact config.

3. Make your first call

Ask your agent: “Check my XentFi agent info and list my wallets.” — this calls xentfi_get_agent_info then xentfi_list_wallets. Full tool list: Tools Reference.

1. Get your organization’s WAAS credentials

Your apiKey / orgId from dashboard.xentfi.com — see Authentication. Only needed if you’re the one getting paid (verifying/settling); a pure payer needs no XentFi credentials at all.

2. Install and check supported configs

npm install @xentfi/x402-facilitator-sdk

import { X402FacilitatorClient } from "@xentfi/x402-facilitator-sdk";

const facilitator = new X402FacilitatorClient({
  apiKey: process.env.WAAS_API_KEY!,
  orgId: process.env.WAAS_ORG_ID!,
});

const supported = await facilitator.getSupported();
console.log(supported); // valid blockchainId/assetId pairs, no auth required

3. Verify and settle a payment (resource server) — or sign one (payer)

// Resource server: verify then settle an incoming X-PAYMENT
await facilitator.verify(paymentPayload, requirement);
const settlement = await facilitator.settle(paymentPayload, requirement);

Full walkthroughs for both sides: essentials/x402. API surface: x402 Reference.

Next steps

Authentication

Agent API Keys vs. WAAS keys, side by side.

MCP Tools guide

Every client integration, in full.

x402 guide

The full 402 protocol flow, both sides.

Error Handling

How policy denials and facilitator errors surface.

​1. Create an Agent and get an Agent API Key

​2. Connect an MCP client

​3. Make your first call

​1. Get your organization’s WAAS credentials

​2. Install and check supported configs

​3. Verify and settle a payment (resource server) — or sign one (payer)

​Next steps