TroqPay MCP Server
troqpay/agent-plugin
Integração de pagamentos TroqPay para agentes Claude
Ver no GitHubServidor MCP oficial que expõe ferramentas de pagamento do TroqPay para Claude Desktop, Codex e outros clientes MCP. Permite criar checkouts, consultar saldos e gerenciar saques através de uma integração segura baseada em variáveis de ambiente.
Instalação
npx convez-ai troqpay/agent-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar checkouts de pagamento via Claude
- Consultar saldos e transações da conta TroqPay
- Automatizar saques em ambientes server-side
- Integrar pagamentos em fluxos de agentes IA
Veredito

Plugin maduro e bem documentado para integração de pagamentos. Modelo de segurança sólido com credenciais em variáveis de ambiente e desativação padrão de operações sensíveis como saques. Adequado para aplicações que precisam processar pagamentos através de agentes Claude.
README
A tradução para o português deste README ainda está na fila.
troqpay plugin
MCP server and Codex plugin wrapper for troqpay.
The plugin exposes payment tools to Codex, Claude Desktop, and other MCP clients:
troqpay_create_checkouttroqpay_get_checkouttroqpay_get_balancetroqpay_create_withdrawalwhenTROQPAY_ENABLE_WITHDRAWALS=truetroqpay_get_withdrawalwhenTROQPAY_ENABLE_WITHDRAWALS=true
API keys are read from environment variables and are not passed as tool inputs.
Environment
export TROQPAY_API_KEY="trq_test_xxxxxxxxx"
export TROQPAY_BASE_URL="https://api.troqpay.com"
For staging:
export TROQPAY_BASE_URL="https://troqpay-api-staging-production.up.railway.app"
Withdrawal tools are disabled by default. Enable them only in trusted server-side environments:
export TROQPAY_ENABLE_WITHDRAWALS="true"
Never store trq_test_ or trq_live_ keys in this package, marketplace
manifests, repository files, screenshots, or chat transcripts.
Build
npm install
npm run build
Security model
- The plugin is a thin MCP client. The troqpay API remains the money-risk enforcement boundary.
- The plugin vendors only the minimal HTTP client it needs, so public installation does not depend on a local sibling SDK path.
- API keys stay in the host environment and are never accepted as MCP tool arguments.
- Checkout experiments should use
trq_test_keys. - Live operations require
trq_live_keys and server-side API enforcement for production approval, API-key scopes, idempotency, rate limits and audit logs. - Withdrawal tools are opt-in with
TROQPAY_ENABLE_WITHDRAWALS=true. - Runtime startup does not run
npm install; dependencies must be installed as part of the plugin installation/release process.
Public release checklist
Before publishing this plugin outside a local marketplace:
- Remove ignored build artifacts and dependency folders from the release
source, especially
node_modules. - Run
npm ci,npm run verify:public, and a clean MCP smoke test from a fresh clone. - Confirm no
.env, API keys, provider credentials, database URLs, or local checkout artifacts are committed. - Confirm the public API returns structured errors such as
401,403, and503, not raw stack traces. - Keep withdrawal tools disabled by default in marketplace examples.
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"troqpay": {
"command": "node",
"args": ["/absolute/path/to/plugins/troqpay/dist/mcp.js"],
"env": {
"TROQPAY_API_KEY": "trq_test_xxxxxxxxx",
"TROQPAY_BASE_URL": "https://api.troqpay.com"
}
}
}
}
Codex
The plugin bundle includes .codex-plugin/plugin.json,
.claude-plugin/plugin.json, and .mcp.json. After install, set
TROQPAY_API_KEY in the Codex environment before using tools.
The official source repository is:
https://github.com/troqpay/agent-plugin