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

get_balance

Returns the current USDC balance of the agent's wallet across all supported networks.

transfer

Executed a USDC transfer to a specific wallet address or ENS name. Requires amount in USDC.

smart_fetch

Fetches content from x402-enabled URLs. Automatically handles payment negotiation.

vault_gate

Deposits or withdraws USDC from the agent's secure vault channels for higher liquidity.

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