🔌 MCP Server Integration

A hosted MCP server that gives AI assistants (Claude, n8n, etc.) the power to automatically discover, access, and pay for X402-enabled APIs using your AgnicPay wallet.

MCP Server Address

https://mcp.agnic.ai/sse

Use this URL when connecting to the AgnicPay MCP server from any MCP client.

What is This MCP Server?

The AgnicPay MCP server is a hosted remote service that connects your AI tools to the X402 payment protocol. Think of it as a bridge between your AI assistant and paid APIs.

X402 is a new HTTP status code (like 404 for "Not Found") that means "Payment Required". When an API responds with 402, our MCP server automatically:

1. Detects the payment requirement and price
2. Signs the payment using your AgnicPay wallet
3. Retries the request with payment proof
4. Returns the API response to your AI

How to Connect (3 Steps)

Step 1: Create AgnicPay Account & Get API Key

Sign up at pay.agnic.ai, add USDC to your wallet, then generate an API token from your dashboard.

Your API token will look like:

agnic_tok_sk_live_abc123...

Step 2: Add MCP Server to Your AI Client

In your MCP client (n8n, Claude Desktop, etc.), add the AgnicPay MCP server with these details:

Step 3: Start Using AI Tools

Your AI can now access X402 APIs automatically. The MCP server handles all payments in the background!

Available MCP Tools

Your AI assistant gets access to these 6 powerful tools when connected to our MCP server:

🌐 make_x402_request

Automatically fetch data from any X402-enabled API. If payment is required, handles it seamlessly.

Parameters: url, method, headers, body

💰 check_balance

Check your AgnicPay wallet balance across different networks (Base, Solana) before making payments.

Parameters: network (optional)

📜 get_payment_history

View complete payment history with timestamps, amounts, and transaction hashes for full transparency.

Parameters: limit, startDate, network

🔍 discover_apis

Browse and search through available X402-enabled APIs. Check pricing, categories, and popularity.

Parameters: category, search, maxPrice, sort

🔄 trade_tokens

Swap tokens on Base network. Trade USDC for ETH, or any supported token pair via DEX aggregation.

Parameters: sellToken, buyToken, sellAmount, slippagePercentage (optional)

💸 fund_wallet

Get instructions on how to fund your AgnicPay wallet with USDC for API payments.

Parameters: network (optional)

Example: Connecting in n8n

In your n8n workflow, add an MCP Client node:

// 1. Add MCP Client node configuration
{
  "serverType": "HTTP/SSE",
  "serverUrl": "https://mcp.agnic.ai/sse",
  "authHeader": "Authorization: Bearer agnic_tok_sk_live_..."
}
 
// 2. Use the make_x402_request tool
{
  "tool": "make_x402_request",
  "parameters": {
    "url": "https://api.example.com/data",
    "method": "POST",
    "body": {
      "prompt": "Generate a summary"
    }
  }
}
 
// The MCP server handles payment automatically!

That's it! Your n8n workflow can now access paid APIs. The MCP server handles payment automatically.

Claude Desktop Configuration

Add AgnicPay to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "agnicpay": {
      "url": "https://mcp.agnic.ai/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer agnic_tok_sk_live_..."
      }
    }
  }
}

Perfect For

Security Best Practices

1. Use dedicated tokens - Create a token specifically for MCP use
2. Set spending limits - Configure daily/monthly limits on your token
3. Monitor usage - Check your payment history regularly
4. Rotate tokens - Periodically rotate your MCP token

Next Steps