A API REST expõe as operações de pagamento e consulta. A documentação descreve @hodle/mcp como um servidor local via stdio, com ferramentas para Claude Code, Cursor, Codex e Hermes. A skill hodle-api reúne instruções sobre fluxos, KYC e webhooks. Na revisão de 04/10/2026, @hodle/mcp não foi localizado no registro público npm; confirme com a equipe o acesso ao pacote antes de instalar. O repositório indicado para instalar a skill também não estava acessível publicamente nessa revisão; consulte o guia e confirme o acesso.
Na configuração documentada, o MCP usa sandbox por padrão e registra apenas ferramentas de consulta até que HODLE_MCP_ALLOW_WRITES=true seja configurado. Cada chamada de escrita também exige confirm: true. Esse campo é preenchido pelo agente; a aprovação humana depende do controle de ferramentas do cliente MCP.
Cada operação tem requisitos, ativos e redes próprios. Acesso em produção depende da conta, do KYC e das funcionalidades habilitadas.
A API key identifica a conta e seu escopo. No fluxo por PIN, transferências e payouts exigem walletPin e protectedSymmetricKey da carteira de origem. O servidor usa essas credenciais para desbloquear a chave temporariamente em memória e assinar a operação. A aplicação que integra é responsável por guardar e fornecer as credenciais corretas das subcontas.
No MCP, HODLE_WALLET_PIN e HODLE_PROTECTED_SYMMETRIC_KEY ficam no ambiente do processo. O servidor mantém um par de credenciais e recusa payout com subAccountId; payouts de subcontas devem usar uma integração que selecione as credenciais de cada titular.
Use o walletId da carteira de origem. POST /api/wallet/keys retorna walletId, protectedSymmetricKey e email do proprietário; faça cache por walletId junto do email. Atualize esse registro quando a chave protegida daquela carteira mudar, inclusive após uma alteração de PIN que a renove.
Wallet Transfer envia o token na rede escolhida. Wallet Payout converte o saldo elegível para pagar o destinatário em reais via Pix. A disponibilidade de uma rede em um desses endpoints não implica suporte no outro.
USDT
USDC
Bitcoin
Lightning
Polygon
Tron
BaseTire suas dúvidas sobre agentes de IA operando pagamentos pela API.
Sim, com conta e funcionalidades habilitadas, saldo elegível e autorização para a carteira. A API inicia o payout e permite acompanhar seu status e webhooks. No @hodle/mcp, escrita fica desabilitada por padrão; habilitá-la e enviar confirm: true não substitui a aprovação humana no cliente MCP.
A API key identifica a conta. No fluxo por PIN, a integração fornece walletPin e protectedSymmetricKey da carteira selecionada. POST /api/wallet/keys retorna a chave protegida, walletId e email; o cache é por walletId, junto do email, e deve ser atualizado quando essa chave mudar. No MCP, as credenciais de assinatura ficam em variáveis de ambiente.
A integração deve impor os limites de valor, destinatário e escopo e manter as aprovações adequadas. No MCP, HODLE_MCP_ALLOW_WRITES controla a exposição de ferramentas de escrita; confirm: true é um campo que o próprio agente pode preencher, não uma aprovação humana.
A Hodle documenta @hodle/mcp como um servidor local via stdio para Claude Code, Cursor, Codex e Hermes, com sandbox e consultas por padrão. O pacote não foi localizado no npm público na revisão de 04/10/2026; confirme o acesso com a equipe. O guia está em /docs/ai/mcp. O MCP é opcional: a integração REST pode ser feita diretamente.
Consultar carteiras, saldos, extrato e cotações; iniciar payout de stablecoin para Pix, invoices Lightning, depósitos e transferências quando autorizados. Wallet Transfer envia tokens na mesma rede, conforme a matriz do endpoint; não faz bridge. O MCP atual recusa payout de subcontas porque mantém um único par de credenciais de assinatura.
