Skip to main content

​
Overview

Claude supports the Model Context Protocol (MCP), which means ACN services appear as native tools that Claude can call directly. No custom code needed — just configure the MCP servers and start chatting. Authentication is optional. Claude can discover, execute, and pay for capabilities immediately with zero configuration beyond the server URL.

​
Setup

​
1. Configure Claude Desktop

Open Claude Desktop settings and add the ACN MCP servers to your configuration: 
{
  "mcpServers": {
    "acn": {
      "type": "url",
      "url": "https://mcp.acn.exchange/mcp"
    },
    "acn-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": ["acn-agent", "wallet-server"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYourPrivateKey",
        "CHAIN_ID": "8453"
      }
    }
  }
}
Never commit your private key or API key to version control. Use environment variables or a secrets manager.

​
2. Restart Claude Desktop

After saving the configuration, restart Claude Desktop. You should see the ACN tools available in the tools menu.

​
3. Start Using ACN

Simply ask Claude to perform tasks that require external services:
“Find the current price of Bitcoin and Ethereum”
Claude will:
  1. Call acn_discover to find a price data provider
  2. Show you the results and costs
  3. Call acn_execute to run the capability
  4. Handle payment signing via the wallet MCP if required
  5. Call acn_submit_payment to complete the payment
  6. Return the results

​
Available Tools

Once configured, Claude sees these tools: ACN tools:
  • acn_discover — Search the marketplace for capabilities
  • acn_execute — Execute a capability (works without auth)
  • acn_submit_payment — Submit on-chain payment to complete execution
  • acn_auth_status — Check your current identity tier and rate limits
  • acn_balance — Check your wallet balance (requires full auth)
  • acn_call_history — View recent calls and spending (requires full auth)
Wallet tools (via Coinbase AgentKit):
  • get_wallet_details — Get wallet address and chain info
  • get_balance — Check on-chain balance (native + ERC-20)
  • transfer — Send native or ERC-20 tokens
  • sign_message — Sign a message (EIP-191)

​
Example Conversation

You: “I need to send a welcome email to new-user@example.com” Claude: calls acn_discover with query “send transactional email”
I found 3 email providers. Resend offers the best combination of price ($0.002/call) and uptime (99.9%). Let me send the email.
Claude: calls acn_execute with the email capability ACN returns payment_required with amount and unsigned transaction Claude: calls transfer to send USDC payment on-chain Claude: calls acn_submit_payment with the transaction hash
Done! Email sent successfully. Cost: $0.002 USDC.

​
Tips

You can start with the zero-friction config and add x-acn-wallet or an API key later. Your wallet’s trust score builds automatically through payments regardless of auth tier.
You don’t need to know which providers exist. Just describe what you need and Claude will discover the right service.
The discover → execute → pay → submit flow is natural for Claude. It will handle payment signing automatically using the wallet MCP server.
Ask Claude to call acn_auth_status to see your current identity tier, trust level, and rate limits.