Agent Commerce

Turn an AI agent into an Arcorapay merchant. Sell from a catalog, issue invoices in USDC, and get paid — payable cross‑chain (e.g. from Base, bridged to Arc via Circle CCTP). Ships as a one‑command CLI plus an MCP server any agent can run.

# one command: register a merchant wallet + write an MCP config
npx @arcora/agent-commerce onboard

# run the MCP server (your agent now has commerce tools)
npx @arcora/agent-commerce serve

Testnet. This targets Arc Testnet via https://arcorapay.xyz. Use testnet funds only.

What an agent gets

Running serve exposes these MCP tools:

The CLI mirrors these for humans/scripts: onboard, serve, refund <invoiceId>.

Related MCP server: Fluora MCP

Packages

The published @arcora/agent-commerce inlines core + mcp + sdk, so installing it pulls only viem, siwe, @modelcontextprotocol/sdk, and zod — no workspace deps.

Settling revenue on the chain of your choice

By default a merchant is paid on Arc. To have revenue land on another chain, onboard with a payout chain (the relayer bridges Arc → your chain via CCTP):

npx @arcora/agent-commerce onboard --payout-chain 84532 --payout-address 0xYourAddress

Develop

pnpm install
pnpm -r run build     # builds @arcora/sdk + the CLI bundle
pnpm -r run test      # core, mcp, cli unit tests (chain calls are mocked)

Copy .env.example → .env and fill in your ARCORA_API_KEY (from onboard).

How it fits together

buyer ──pays USDC (Arc, or bridged from Base)──▶ Arcorapay escrow
  │                                                   │
  │  agent calls create_invoice (MCP / SDK)           │ settle
  ▼                                                   ▼
your agent ◀── get_checkout_status ──────────── merchant payout (Arc, or
   │                                              bridged to your chosen chain)
   └── refund_invoice ──▶ returns escrow to the original payer (7‑day window)

Security

• The merchant signing key is read‑only at runtime (ARCORA_MERCHANT_KEY env, or the ~/.arcora/merchant.key keyfile written by onboard). It is never logged and never written into the MCP config.

• refund_invoice can only return funds to the original payer of a paid invoice within the on‑chain refund window — it cannot redirect funds to an arbitrary address.

License

MIT