AI agents já conseguem escrever código, navegar na web, gerenciar arquivos e rodar comandos de terminal. O que continua difícil é interagir com sistemas financeiros de forma confiável e segura.
Não porque os modelos sejam incapazes. Porque a maior parte da infraestrutura financeira nunca foi desenhada para software autônomo.
A maioria das APIs fintech foi desenhada para developers e operadores humanos. Elas assumem que alguém está revisando outputs, interpretando failures e decidindo o que fazer em seguida.
AI agents podem trabalhar com essas APIs, mas a confiabilidade fica mais difícil quando os outputs são inconsistentes, os erros não são estruturados ou operações críticas exigem intervenção manual.
Quando há fundos reais envolvidos, comportamento determinístico importa mais do que interpretação esperta. Essa é a lacuna que nos propusemos a fechar com a Uphold.
O que construímos
uphold-cli é uma command-line tool e um MCP server que dá a AI agents acesso programático a capacidades-chave da Uphold: market data, account management, agregação de portfolio e transaction flows.
É distribuído como um único binário em Rust, sem dependências externas.
Market dataTicker e currencies públicos, sem credenciais.
AccountsCards, addresses e agregação de portfolio em uma única interface.
TransactionsO fluxo completo de quote e commit, com review antes de mover fundos.
MCP serverBuilt-in sobre stdio. Sem wrappers de subprocess nem integrações custom.
uphold-cliCommand-line tool e MCP server para a Uphold. JSON estruturado por default. Safe by default. O repositório é privado por enquanto. Devemos abri-lo em breve.
Desenhado agent-first, não agent-compatible
A maioria dos CLIs é construída para humanos e depois adaptada para automation. O uphold-cli foi desenhado ao contrário.
Cada comando devolve JSON estruturado por default. Não porque agents não consigam ler output pensado para humanos, mas porque output estruturado é mais fácil de consumir de forma confiável em workflows automatizados.
Agents trabalham com campos tipados em vez de extrair informação de texto formatado.
O error handling segue o mesmo padrão. Cada failure devolve um envelope categorizado. Um agent que lê isso sabe exatamente o que aconteceu e o que fazer em seguida.
Isso importa em produção. Quando um rate limit dispara, o envelope inclui retryable, suggestion e um docs_url opcional. O agent pode fazer backoff e continuar sem intervenção humana.
| Campo do envelope | Por que importa |
|---|---|
| Category | O agent sabe que tipo de failure está vendo |
| retryable | Se um retry autônomo é seguro |
| suggestion | A next action, sem adivinhar |
| docs_url | Referência opcional quando o agent precisa de mais contexto |
O MCP server
O uphold-cli inclui um Model Context Protocol server built-in sobre stdio. Sem wrappers de subprocess, sem integrações custom.
uphold mcp -s allIsso expõe as capacidades da Uphold como tools invocáveis para qualquer agent compatível com MCP. O agent descobre os comandos disponíveis, seus parâmetros e seus safety flags automaticamente a partir dos tool schemas.
- Claude Desktop
- Cursor
- Codex
- Gemini CLI
- Goose
- OpenClaw
Um único bloco de configuração MCP basta para expor toda a command surface:
{
"mcpServers": {
"uphold": {
"command": "uphold",
"args": ["mcp", "-s", "all"]
}
}
}A partir daí, um agent pode rodar prompts como:
Portfolio review"Liste meus cards, totalize meu portfolio em USD e diga o que se destaca."
Market watch"Observe BTCUSD, ETHUSD e XRPUSD por 30 segundos. Quais os prós e contras de cada um agora?"
Quote before commit"Crie um quote do meu card USD para BTC e explique os detalhes antes de commitar."
Mesma interfaceSão exemplos de workflows reais para os quais a tool foi desenhada.
A camada MCP expõe automaticamente schemas de comandos, parâmetros, descrições e requisitos de segurança.
Safe by default
Operações financeiras precisam de safety layers explícitas. O uphold-cli tem dois modos.
Guarded mode (default)Qualquer comando que possa mover fundos exige acknowledged=true como parâmetro explícito. O agent não consegue commitar uma transação por acidente sem essa confirmação. Tools perigosas são marcadas com [DANGEROUS: requires human confirmation] nas descrições MCP, para que qualquer agent que leia o schema saiba antes de chamar.
Autonomous mode (--allow-dangerous)O requisito de confirmação é removido. É o modo para pipelines em que o humano já revisou a lógica e confia no agent para executar sem checkpoints.
A distinção não é cosmética. É a diferença entre uma tool segura para conectar a um agent em tarefas exploratórias e uma endurecida para execução financeira autônoma. O modo default otimiza por segurança. Execução autônoma é uma escolha explícita.
Os binários são reproduzíveis e verificáveis. Secrets nunca são impressos no output do CLI. Arquivos de config são criados com permissões restritas.
O que a command surface cobre
Comandos em seis grupos:
- ticker
- currencies
- configure
- account
- trade
- auth
O grupo account cobre cards, addresses e agregação de portfolio. O grupo trade cobre o fluxo completo de quote e commit: criar quotes, revisá-los e commitar só quando estiver pronto. Ticker e currencies públicos não exigem credenciais. Fluxos autenticados usam a mesma interface, apontando para sandbox ou live.
Sandbox é first-class. Aponte o CLI para o ambiente sandbox da Uphold, fondeie uma conta de teste com XRP de teste e rode o fluxo completo de auth e transações sem tocar assets reais. Os mesmos comandos, o mesmo formato de output, sem risco financeiro.
Por que esta colaboração fazia sentido
A Uphold tem a infraestrutura financeira. A WakeUp Labs constrói a camada de sistemas que torna essa infraestrutura operável por máquinas.
Isto não é uma integração genérica. Levou decisões deliberadas sobre formatos de output, taxonomia de erros, safety flags, tool schemas de MCP e distribuição de binários para que um AI agent possa de fato confiar nisso em produção. O tipo de decisão que é invisível quando está certa e catastrófica quando está errada.
O uphold-cli é o primeiro marco de uma colaboração mais longa. O objetivo é maior do que um CLI: tornar a Uphold nativamente acessível para a próxima geração de sistemas financeiros autônomos.
Vamos compartilhar mais detalhes à medida que o projeto evoluir.
O uphold-cli é um exemplo de um shift mais amplo: infraestrutura financeira desenhada não só para humanos, mas também para sistemas autônomos.
À medida que AI agents se tornam capazes de executar workflows cada vez mais complexos, a qualidade das interfaces subjacentes fica tão importante quanto as capacidades dos próprios modelos. A próxima geração de infraestrutura financeira vai precisar ser desenhada para humanos e para máquinas.
A WakeUp Labs projeta, constrói e opera sistemas financeiros críticos. Da infraestrutura às operations em produção, o foco é sempre o mesmo: transformar capacidades novas em coisas que realmente funcionam.