Modexia-mcp

---

name: modexia-mcp version: 0.4.1 description: O servidor oficial do Model Context Protocol (MCP) para Agentes de IA autônomos interagirem com a infraestrutura cripto da Modexia. author: Modexia homepage: https://github.com/Modexia/ModexiaAgentpay tags:

• mcp
• web3
• payments avatar: https://raw.githubusercontent.com/Modexia/ModexiaAgentpay/main/apps/mcp-server/assets/modexialogo.png config: type: stdio command: uvx args:
  • modexia-mcp skills:
• nanopay
• nanopay_activate
• nanopay_deposit
• nanopay_withdraw
• nanopay_balance
• submit_intent
• get_intent
• list_intents
• open_channel
• consume_channel
• settle_channel
• get_channel
• list_channels
• get_balance
• get_history
• transfer
• cross_chain_transfer
• smart_fetch prompts:
• nanopay_usage_instruction
• create_intent_payment_instruction
• setup_microtransactions_instruction
• create_payment_instruction resources:
• modexia://docs/llms_context

---

[](https://lobehub.com/mcp/modexia-modexia-mcp)

Bem-vindo ao Servidor MCP Modexia AgentPay (modexia-mcp). Este servidor preenche a lacuna entre Modelos de Linguagem de Grande Porte e a economia digital do mundo real.

Ao integrar este servidor padrão do Model Context Protocol (MCP) à sua pilha de IA (Claude Desktop, LobeChat, Dify ou enxames multiagentes personalizados), você equipa instantaneamente seus Agentes de IA com uma Carteira de Contrato Inteligente programável.

Em vez de seus agentes encontrarem erros 402 Payment Required e falharem, eles agora podem negociar paywalls de forma autônoma, comprar dados premium, executar microtransações sem taxa de gás via Circle Gateway e negociar recursos computacionais com outros agentes em canais de vault de alta frequência.

A Modexia dá ao seu IA uma conta bancária, e o MCP dá a ele as ferramentas para usá-la.

---

Novidades na v0.4.1

Nanopagamentos Circle Gateway (x402) Esta versão traz suporte agêntico completo para microtransações sem gás e de frações de centavo diretamente no nível do MCP.

• nanopay — Busque uma URL protegida por x402 e negocie automaticamente o pagamento usando assinaturas offline EIP-3009. Inclui lógica de recarga automática embutida.
• nanopay_activate — Ativação única para o agente.
• nanopay_deposit / nanopay_withdraw — Gerencie fundos do gateway diretamente da carteira principal.
• nanopay_balance — Acompanhe o Saldo Disponível Real (depósitos do gateway menos assinaturas pendentes/não liquidadas).
• Tratamento Estruturado de Erros — As ferramentas MCP agora retornam códigos ModexiaPaymentError estruturados (por exemplo, INSUFFICIENT_MAIN_BALANCE) para que o LLM possa raciocinar sobre falhas e tomar ações corretivas.

---

Anterior: Novidades na v0.3.0 (Intent-to-Pay)

Pagamentos Baseados em Intenção (v2) Execute pagamentos padrão em USDC por meio de um pipeline de conformidade rigoroso com feedback rico.

• submit_intent — Crie uma intenção assinada, valide contra políticas e execute on-chain.
• get_intent / list_intents — Trilha de auditoria e rastreamento.

---

Recursos

• Integração Circle Gateway: Acesso programático direto à infraestrutura de nanopagamentos USDC da Circle.
• Microtransações Sem Gás: Envie pagamentos a partir de $0,000001 com zero taxas de blockchain.
• Assinaturas Offline EIP-3009: Autorizações de pagamento seguras e off-chain que previnem gastos duplicados.
• Roteamento Baseado em Intenção: Aplicação rigorosa de políticas, limites diários de gastos e trilhas de auditoria criptográficas.
• Negociação Automatizada de Paywalls: Detecte automaticamente cabeçalhos 402 Payment Required e atenda-os inline.
• Recarga Automática Inteligente: Recarregue perfeitamente os saldos do gateway a partir da carteira principal quando os fundos estiverem baixos.

---

Componentes MCP Expostos

Ferramentas

Nome da Ferramenta	Descrição
nanopay	Negocie e pague automaticamente URLs 402 Payment Required usando assinaturas offline EIP-3009.
nanopay_activate	Comando de ativação única para habilitar nanopagamentos Circle Gateway para o agente.
nanopay_deposit	Deposite fundos da carteira principal do agente para o Gateway de nanopagamentos.
nanopay_withdraw	Retire fundos não utilizados do Gateway de volta para a carteira principal.
nanopay_balance	Verifique o Saldo Disponível Real (depósitos do gateway menos assinaturas pendentes).
submit_intent	Execute um pagamento padrão em USDC com conformidade e aplicação de políticas.
get_intent	Recupere o status e os metadados de conformidade de uma intenção de pagamento enviada anteriormente.
list_intents	Busque intenções de pagamento recentes para revisão da trilha de auditoria.
open_channel	Bloqueie fundos em um contrato inteligente para microtransações de alta frequência.
consume_channel	Execute micropagamentos instantâneos e sem gás dentro de um canal aberto.
settle_channel	Feche o vault e distribua fundos on-chain.
get_channel	Verifique a capacidade atual e o estado de um canal de pagamento específico.
list_channels	Liste todos os canais de pagamento associados à carteira do agente.
get_balance	Recupere o saldo atual em USDC da Carteira de Contrato Inteligente principal do agente.
get_history	Busque o histórico recente de transações do agente.
transfer	Execute uma transferência USDC síncrona padrão (v1).
cross_chain_transfer	Execute um pagamento CCTP entre cadeias via Squid Router (por exemplo, Ethereum -> Akash).
smart_fetch	Negociação automática HTTP legada para paywalls baseados em HTTP.

Prompts

Nome do Prompt	Descrição
nanopay_usage_instruction	Melhores práticas para financiar o gateway e executar operações nanopay.
create_intent_payment_instruction	Regras para estruturar pagamentos em conformidade, adicionar memos e lidar com rejeições de políticas.
setup_microtransactions_instruction	Guia passo a passo para abrir, consumir e liquidar canais de vault.
create_payment_instruction	Regras padrão para transferências legadas baseadas em idempotência.

Recursos

URI do Recurso	Descrição
modexia://docs/llms_context	O Guia Completo do Protocolo de Desenvolvedor Modexia com regras econômicas abrangentes para enxames.

---

Configuração e Setup

Este servidor requer uma Chave de API Modexia para funcionar. Você pode obter uma criando uma conta de desenvolvedor em modexia.software.

Variável	Descrição
MODEXIA_API_KEY	Obrigatória. Sua chave de desenvolvedor Modexia (por exemplo, mx_test_...)
MODEXIA_BASE_URL	Opcional. Substitui o endpoint da API. Padrão: Ambiente Sandbox.

Usando uvx (Recomendado)

Você pode executar este servidor diretamente em qualquer cliente MCP que suporte comandos executáveis padrão:

uvx modexia-mcp

Claude Desktop

Para usar a Modexia com o Claude Desktop, adicione o seguinte ao seu claude_desktop_config.json:

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

---

Contribuindo para o Open Source

Aceitamos ativamente contribuições da comunidade para tornar este servidor MCP ainda melhor. Como ele atua como a interface principal para agentes de IA autônomos, priorizamos fortemente estabilidade e engenharia de prompt rigorosa.

1. Clone o Repositório: git clone https://github.com/Modexia/modexia-mcp.git
2. Instale as Dependências: pip install -e .
3. Execute Localmente: Você pode executar o servidor em modo stdio para testes locais via python -m modexia_mcp
4. Envie PRs: Abra um Pull Request direcionado ao branch main.

---

Modelo de Segurança

O Servidor MCP Modexia nunca expõe suas chaves privadas ao contexto do LLM. A IA só tem permissão para acionar ferramentas MCP explicitamente configuradas. Limites de política (por exemplo, gasto máximo diário, limites por hora) são aplicados automaticamente no backend da Modexia. Mesmo uma IA com alucinações não pode drenar sua carteira além dos seus guarda-corpos predefinidos.

Licença e Suporte

modexia-mcp é uma ferramenta de código aberto regida pela Licença MIT.

Precisa de ajuda para escalar seu enxame de agentes ou configurar suas chaves de API? Acesse seu painel de desenvolvedor e explore a documentação em modexia.software.