agent-commerce
Integrates with Circle's CCTP for cross-chain USDC bridging, enabling merchants to receive payments on their chosen blockchain.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 serveTestnet. This targets Arc Testnet via
https://arcorapay.xyz. Use testnet funds only.
What an agent gets
Running serve exposes these MCP tools:
Tool | What it does |
| List the products this merchant sells (id, name, price). |
| Create an invoice for a catalog item → returns an invoice id + checkout URL. The buyer can pay in USDC on Arc or bridge from Base. |
| Look up an invoice's status: |
| Refund a paid invoice — returns the escrowed USDC to the original payer on Arc, within the 7‑day refund window. Registered only when a merchant signing key is available; funds cannot be redirected. |
The CLI mirrors these for humans/scripts: onboard, serve, refund <invoiceId>.
Related MCP server: InventPay MCP Server
Packages
Package | Published as | Role |
| Thin client for the Arcorapay public API (create invoice, status, webhooks). | |
|
| |
| MCP stdio server ( | |
| The one‑command CLI: |
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 0xYourAddressDevelop
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_KEYenv, or the~/.arcora/merchant.keykeyfile written byonboard). It is never logged and never written into the MCP config.refund_invoicecan 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.
Documentation
Litepaper — English · Türkçe: what it is, how payments flow, why USDC/Arc/CCTP, the trust & security model.
Roadmap — English · Türkçe: what's done and what's next (mainnet, sponsored gas, more chains).
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Sell to people and AI agents: create products, a storefront, and USDC payment links from chat.
Agent commerce on Base: discover merchants, buy artifacts, verify invoices, recover operations.
Let your agent open a store, list digital products and share USDC checkout links. Test mode.
Marketplace and payment rail for AI agents: list, buy and settle with signed receipts.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to autonomously browse inventory, negotiate terms, manage carts, and execute secure payments on Shopify stores using standardized protocols. It provides a bridge for LLMs to handle the entire commerce lifecycle from discovery to order tracking through a verifiable mandate chain.52MIT
- AlicenseAqualityCmaintenanceEnables AI agents to manage crypto payments, stores, products, and orders through the Model Context Protocol.2074 npmMIT
- AlicenseNot gradedqualityBmaintenanceAccept crypto payments from AI agents: create an invoice in one call and get a hosted checkout link (USDC/USDT on Celo, Base, Arbitrum, Polygon, BSC). No API key, instant self-custody settlement.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to discover and interact with a merchant's commerce layer, including product listing and checkout creation, while payments settle directly to the merchant's Stripe account.MIT