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.

​
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",
      "headers": {
        "x-acn-api-key": "acn_sk_your_api_key"
      }
    },
    "acn-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": ["acn-agent", "wallet-server"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYourPrivateKey",
        "CHAIN_ID": "8453"
      }
    }
  }
}

​
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 the provider’s tool (e.g., coingecko__get_price)
  4. Handle payment signing via the wallet MCP
  5. Return the results

​
Available Tools

Once configured, Claude sees these tools: Core tools:
  • acn_discover — Search for services
  • acn_providers — List all providers
  • acn_provider_detail — Get provider info
  • acn_balance — Check your balance
  • acn_call_history — View recent calls
  • acn_submit_payment — Submit signed payment
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)
Dynamic provider tools:
  • resend__send_email, coingecko__get_price, etc. — One tool per provider endpoint

​
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 resend__send_email ACN returns payment_required with unsigned transaction Claude: calls transfer to send USDC payment on-chain Claude: calls acn_submit_payment with signed transaction
Done! Email sent successfully. Cost: 0.002USDC.Yourremainingbalanceis0.002 USDC. Your remaining balance is 10.498.

​
Tips

You don’t need to know which providers exist. Just describe what you need and Claude will discover the right service.
The discover → pay → execute flow is natural for Claude. It will handle payment signing automatically using the wallet MCP server.
If you’re concerned about costs, configure spending limits in your agent.config.json. Claude will respect these limits.