Model Context Protocol (MCP) tooling

The @arcenpay/agent package exports 15 standard Model Context Protocol (MCP) tool definitions via ARCENPAY_MCP_TOOL_DEFINITIONS and provides a built-in dispatcher createArcenAgentMcpTools(agent). It also ships a ready-to-run stdio MCP server (arcenpay-mcp) — no server boilerplate required.

The 15 Production MCP Tools

0. Runtime & session tools (3 tools)

Tool Name	Description	Required Arguments
`arcenpay_check_balance`	Reads the agent’s available on-chain balance (Session Vault, Stellar Horizon, or wallet token balance).	—
`arcenpay_fund_session`	Pre-funds a session vault with USDC to enable x402 micro-payments.	`amount`
`arcenpay_fetch`	Performs an x402 payment-gated HTTP request, auto-negotiating 402 challenges within budget.	`url`

1. Payment link tools (4 tools)

Tool Name	Description	Required Arguments
`arcenpay_resolve_payment_link`	Discovers and inspects payment link specs without spending funds.	`urlOrSlug`
`arcenpay_pay_payment_link`	Executes autonomous payment for a link within safety budgets.	`urlOrSlug`
`arcenpay_create_payment_link`	Programmatically creates a payment link for agent merchants.	`title`, `amount`
`arcenpay_get_spend_summary`	Returns real-time budget diagnostics, daily spent, and limits.	—

2. ArcenAuth Mandate & Policy tools (4 tools)

Tool Name	Description	Required Arguments
`arcenpay_issue_mandate`	Issues and signs an Autonomous Agent Mandate for worker agents.	`childAgentId`, `childPublicKey`
`arcenpay_check_policy`	Evaluates a prospective transaction against deterministic policy rules.	`amount`
`arcenpay_revoke_mandate`	Revokes an active mandate locally and notifies registry/on-chain contract.	`mandateId`
`arcenpay_mandate_status`	Queries delegation state, remaining depth, and revocation status.	—

3. Verify-Then-Settle Escrow tools (4 tools)

Tool Name	Description	Required Arguments
`arcenpay_fetch_escrowed`	Initiates an escrow-backed request (`exact_hash` or `schema_conformance`).	`url`
`arcenpay_verify_commitment`	Verifies provider deliverable against commitment before settlement.	`commitment`, `payload`
`arcenpay_dispute_claim`	Files a dispute against an invalid deliverable for an automated refund.	`requestNonce`
`arcenpay_settlement_status`	Checks reservation, challenge window, and settlement status.	`requestNonce`

Run the MCP server (`arcenpay-mcp`)

The package ships a stdio MCP server. Point any MCP host at it:

AGENT_PRIVATE_KEY=0x... CHAIN_ID=84532 npx -y -p @arcenpay/agent arcenpay-mcp

Environment variable	Required	Purpose
`AGENT_PRIVATE_KEY`	Yes	EVM hex, Stellar secret (`S…`), or Solana base58/JSON secret. Never logged.
`CHAIN_ID`	No	Chain to operate on. Defaults to `84532` (Base Sepolia).
`RPC_URL`	No	On-chain RPC endpoint.
`ARCENPAY_API_URL`	No	API base URL. Defaults to production; set `http://localhost:3300` for local.
`ARCENPAY_API_KEY`	No	For merchant/provider operations (e.g. creating payment links).
`MAX_AUTO_APPROVE`, `MAX_DAILY_SPEND`	No	Budget guardrails.
`AGENT_STORE_PATH`	No	Persists nonce/session state across restarts (`FileStore`).

Never paste a real private key into a shared config or commit it. Use your host’s secret/env mechanism.

Programmatic use

Build a custom server (or embed the tools in your own runtime) with the exported primitives:

import { ArcenAgent, createArcenAgentMcpTools } from "@arcenpay/agent";

const agent = new ArcenAgent({
  privateKey: process.env.AGENT_PRIVATE_KEY,
  chainId: 84532,
});

const mcp = createArcenAgentMcpTools(agent);
// mcp.tools              → MCP tool definitions
// mcp.handleToolCall(name, args) → { content, isError }

Connecting to Claude Desktop

Add the server to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arcenpay": {
      "command": "npx",
      "args": ["-y", "-p", "@arcenpay/agent", "arcenpay-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYourPrivateKey...",
        "CHAIN_ID": "84532"
      }
    }
  }
}

Now, when you ask Claude:

“Inspect the payment link at https://app.arcenpay.com/pay/dataset-alpha and pay it if it costs under $10”

Claude will call arcenpay_resolve_payment_link, check the budget, and execute arcenpay_pay_payment_link autonomously.

React SDK

Node.js SDK

Agent SDK

Model Context Protocol (MCP) tooling

The 15 Production MCP Tools

0. Runtime & session tools (3 tools)

1. Payment link tools (4 tools)

2. ArcenAuth Mandate & Policy tools (4 tools)

3. Verify-Then-Settle Escrow tools (4 tools)

Run the MCP server (`arcenpay-mcp`)

Programmatic use

Connecting to Claude Desktop

​The 15 Production MCP Tools

​0. Runtime & session tools (3 tools)

​1. Payment link tools (4 tools)

​2. ArcenAuth Mandate & Policy tools (4 tools)

​3. Verify-Then-Settle Escrow tools (4 tools)

​Run the MCP server (arcenpay-mcp)

​Programmatic use

​Connecting to Claude Desktop

The 15 Production MCP Tools

0. Runtime & session tools (3 tools)

1. Payment link tools (4 tools)

2. ArcenAuth Mandate & Policy tools (4 tools)

3. Verify-Then-Settle Escrow tools (4 tools)

Run the MCP server (`arcenpay-mcp`)

Programmatic use

Connecting to Claude Desktop