Modexia MCP Server

<h1>Modexia AgentPay MCP Server</h1> <b>The official Model Context Protocol (MCP) server for autonomous AI Agents to interact with Modexia's crypto

Local serverstdioPython

What is the Modexia MCP MCP server?

Modexia MCP MCP server exists for a simple reason — assistants are far more useful when they can act on Modexia MCP directly instead of describing what you should do. Modexia AgentPay MCP Server The official Model Context Protocol (MCP) server for autonomous AI Agents to interact with Modexia's crypto infrastructure..

What you get

  • Circle Gateway Integration: — Direct programmatic access to Circle's USDC nanopayment infrastructure
  • Gas-Free Microtransactions: — Send payments as low as $0.000001 with zero blockchain fees
  • EIP-3009 Offline Signatures: — Secure, off-chain payment authorizations that prevent double-spending
  • Intent-Based Routing: — Strict policy enforcement, daily spend limits, and cryptographic audit trails
  • Automated Paywall Negotiation: — Automatically detect 402 Payment Required headers and fulfill them inline
  • Smart Auto-Refill: — Seamlessly top-up gateway balances from the main wallet when funds run low

What the assistant can call

Once Modexia MCP is connected, these are the calls the assistant has available:

  • nanopay — Auto-negotiate and pay for 402 Payment Required URLs using EIP-3009 offline signatures
  • nanopay_activate — One-time activation command to enable Circle Gateway nanopayments for the agent
  • nanopay_deposit — Deposit funds from the main agent wallet to the nanopayment Gateway
  • nanopay_withdraw — Withdraw unused funds from the Gateway back to the main wallet
  • nanopay_balance — Check the True Available Balance (Gateway deposits minus pending signatures)
  • submit_intent — Execute a standard USDC payment with compliance and policy enforcement
  • get_intent — Retrieve the status and compliance metadata of a previously submitted payment intent
  • list_intents — Fetch recent payment intents for audit trail review
  • open_channel — Lock funds into a smart contract for high-frequency micro-transactions
  • consume_channel — Execute instant, gas-free micro-payments inside an open channel
  • settle_channel — Close the vault and distribute funds on-chain
  • get_channel — Check the current capacity and state of a specific payment channel

Setting it up

The server ships on PyPI as args, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

You will need 2 environment variables: MODEXIA_API_KEY, MODEXIA_BASE_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Choosing this one

This sits in the payments and commerce group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Modexia MCP's toolset — nanopay, nanopay_activate, nanopay_deposit and 11 more — is a fair guide to whether it matches your workflow. It is maintained by modexia; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Modexia MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Modexia MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the modexia mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
nanopayAuto-negotiate and pay for 402 Payment Required URLs using EIP-3009 offline signatures.
nanopay_activateOne-time activation command to enable Circle Gateway nanopayments for the agent.
nanopay_depositDeposit funds from the main agent wallet to the nanopayment Gateway.
nanopay_withdrawWithdraw unused funds from the Gateway back to the main wallet.
nanopay_balanceCheck the True Available Balance (Gateway deposits minus pending signatures).
submit_intentExecute a standard USDC payment with compliance and policy enforcement.
get_intentRetrieve the status and compliance metadata of a previously submitted payment intent.
list_intentsFetch recent payment intents for audit trail review.
open_channelLock funds into a smart contract for high-frequency micro-transactions.
consume_channelExecute instant, gas-free micro-payments inside an open channel.
settle_channelClose the vault and distribute funds on-chain.
get_channelCheck the current capacity and state of a specific payment channel.
list_channelsList all payment channels associated with the agent's wallet.
get_balanceRetrieve the current USDC balance of the agent's primary Smart Contract Wallet.

How to install the Modexia MCP MCP server

{
  "mcpServers": {
    "modexia": {
      "command": "uvx",
      "args": ["args"],
      "env": {
        "MODEXIA_API_KEY": "your-value",
        "MODEXIA_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
MODEXIA_API_KEYCredential the server authenticates with.Yes
MODEXIA_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Modexia MCP to nanopay.
  • Use Modexia MCP to nanopay activate.
  • Use Modexia MCP to nanopay deposit.

Frequently asked questions

It connects Modexia MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (nanopay, nanopay_activate, nanopay_deposit, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Modexia MCP directly.