Modexia-mcp
Description
The financial infrastructure for autonomous AI. Equips Claude and other agents with secure, programmable USDC smart accounts (ERC-4337). Tools exposed: get_balance, transfer_usdc, get_history. Features: Abstracted gas fees (Paymasters), native USDC settlement on Base, and strict…
About
The financial infrastructure for autonomous AI. Equips Claude and other agents with secure, programmable USDC smart accounts (ERC-4337). Tools exposed: get_balance, transfer_usdc, get_history. Features: Abstracted gas fees (Paymasters), native USDC settlement on Base, and strict developer-defined spending limits…
Details
- Author
- modexia
- Categories
- Developer Tools, Other, Finance
Jump to
Setup
Install Modexia-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/modexia/modexia-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
name: modexia-mcp version: 0.4.1 description: The official Model Context Protocol (MCP) server for autonomous AI Agents to interact with Modexia's crypto infrastructure. author: Modexia homepage:https://github.com/Modexia/ModexiaAgentpaytags:
- mcp
- web3
- payments avatar:https://raw.githubusercontent.com/Modexia/ModexiaAgentpay/main/apps/mcp-server/assets/modexialogo.pngconfig: type: stdio command: uvx args:
- modexia-mcp skills:
The official Model Context Protocol (MCP) server for autonomous AI Agents to interact with Modexia's crypto infrastructure.
Welcome to theModexia AgentPay MCP Server(modexia-mcp). This server bridges the gap between Large Language Models and the real-world digital economy.
By integrating this standard Model Context Protocol (MCP) server into your AI stack (Claude Desktop, LobeChat, Dify, or custom multi-agent swarms), you instantly equip your AI Agents with aprogrammatic Smart Contract Wallet.
Instead of your agents hitting402 Payment Requirederrors and failing, they can now autonomously negotiate paywalls, purchase premium data, execute zero-gas microtransactions via Circle Gateway, and trade compute resources with other agents in high-frequency vault channels.
Modexia gives your AI a bank account, and MCP gives it the tools to use it.
Circle Gateway Nanopayments (x402)This release brings full agentic support for gas-free, sub-cent microtransactions directly to the MCP level.
- nanopay— Fetch an x402-protected URL and automatically negotiate the payment using EIP-3009 offline signatures. Includes inline auto-refill logic.
- nanopay_activate— One-time activation for the agent.
- nanopay_deposit/nanopay_withdraw— Manage gateway funds directly from the main wallet.
- nanopay_balance— Track the True Available Balance (Gateway deposits minus pending/unsettled signatures).
- Structured Error Handling— The MCP tools now pass back structuredModexiaPaymentErrorcodes (e.g.,INSUFFICIENT_MAIN_BALANCE) so the LLM can reason about failures and take corrective action.
Previous: What's New in v0.3.0 (Intent-to-Pay)
Intent-Based Payments (v2)Execute standard USDC payments through a strict compliance pipeline with rich feedback.
- submit_intent— Create a signed intent, validate against policies, and execute on-chain.
- get_intent/list_intents— Audit trail and tracking.
- 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 detect402 Payment Requiredheaders and fulfill them inline.
- Smart Auto-Refill:Seamlessly top-up gateway balances from the main wallet when funds run low.
This server requires a Modexia API Key to function. You can obtain one by creating a developer account atmodexia.software.
You can run this server directly in any MCP client that supports standard executable commands:
To use Modexia with Claude Desktop, add the following to yourclaude_desktop_config.json:
{ "mcpServers": { "modexia": { "command": "uvx", "args": ["modexia-mcp"], "env": { "MODEXIA_API_KEY": "mx_test_YourApiKeyHere" } } } }
We actively welcome community contributions to make this MCP server even better. Because it acts as the primary interface for autonomous AI agents, we heavily prioritize stability and strict prompt engineering.
- Clone the Repo:git clone https://github.com/Modexia/modexia-mcp.git
- Install Dependencies:pip install -e .
- Run Locally:You can run the server in stdio mode for local testing viapython -m modexia_mcp
- Submit PRs:Open a Pull Request targeting themainbranch.
The Modexia MCP Serverneverexposes your private keys to the LLM context. The AI only has permission to trigger explicitly configured MCP tools. Policy limits (e.g., maximum daily spend, hourly caps) are enforced automatically on the Modexia backend. Even a hallucinating AI cannot drain your wallet above your predefined guards.
modexia-mcpis an open-source tool governed by theMIT License.
Need help scaling your agent swarm or configuring your API keys? Access your developer dashboard and explore the docs atmodexia.software.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.
Interact with the CW-Social smart contract on Cosmos-based blockchains.
A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI.
About MCP server for TRON blockchain — connect AI agents to TRX, TRC20, smart contracts, staking & governance via GoTRON SDK
Provides onchain tools for AI applications to interact with the Hashkey Network.
Integrates with the Hyperlane protocol for cross-chain messaging and smart contract interactions.
An MCP server for Solana development providing basic RPC methods and helpful prompts.
An MCP server providing access to various Starknet RPC methods.
An MCP server for interacting with the Tatara blockchain ecosystem. Requires configuration for the Tatara RPC endpoint and a wallet private key.
Deploy and manage compliant tokens from Claude, Cursor, or any AI agent — by typing a sentence.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
