Model Context Protocol

The Modexia MCP server provides a standardized interface for AI agents (like Claude Desktop) to interact with the Modexia payment network using natural language tools.

Installation & Setup

The easiest way to run the server is using uvx, which handles all dependencies automatically.

bash

uvx modexia-mcp

Environment Variables

You must provide your Modexia API key via env vars. We recommend using a Testnet key for development.

MODEXIA_API_KEYRequired

Claude Desktop Configuration

Add the following to your claude_desktop_config.json file to enable Modexia tools.

json

{
  "mcpServers": {
    "modexia": {
      "command": "uvx",
      "args": ["modexia-mcp"],
      "env": {
        "MODEXIA_API_KEY": "mx_test_..."
      }
    }
  }
}

Comprehensive Tool Reference

submit_intent

Submit a standard payment using the secure Intent-to-Pay API. Returns rich compliance data.

nanopay

Automatically fetch and pay for x402-protected URLs using zero-gas Gateway EIP-3009 signatures.

cross_chain_transfer

Route USDC from your agent's Base wallet directly to an address on another blockchain.

get_balance

Retrieve the current on-chain USDC balance for the agent's wallet.

Security & Spending Limits

Modexia MCP honors all spending policies configured in the Modexia Dashboard. Use session-based keys to restrict agent access in production environments.

Configure Policies