Uma camada de API REST + MCP feita para agentes autônomos. Cadastre-se, recarregue com cripto e emita cartões em 4 chamadas — sem nenhum humano no meio, sem KYC, com escopos por chave e limites de taxa completos.
Os endpoints abaixo são a base — os padrões são o que os construtores de agentes realmente colocam em produção.
Agentes que decidem o que comprar e executam a compra sem aprovação humana. A API emite um cartão novo por transação, cobra e depois o exclui — sem deixar nenhuma superfície de pagamento reutilizável solta por aí.
Emissão programática de um cartão BIN-471938 (Visa Business) por conta de anúncios Meta / Google / TikTok. Rotacione cartões a cada 30-60 dias para manter as contas limpas.
Marketplaces ou plataformas que precisam de um cartão único por transação de usuário final. Emita, cobre, exclua em menos de 10 segundos — sem escopo PCI, sem peso de armazenar cartões.
Cadastre-se em testes gratuitos em escala. Cada teste recebe um cartão com a recarga mínima; excluir antes da renovação bloqueia a cobrança automática de forma limpa.
Agentes multi-tenant que cobram SaaS upstream (AWS, OpenAI, Cloudflare, GitHub) em um cartão por workspace. Os custos passam a ser atribuíveis ao cliente sem vazar sua identidade de cobrança mestre.
Cada worker solicita um cartão via API no momento em que precisa de uma superfície de pagamento, usa para a ação pretendida e o fecha. O custo unitário de US$ 1,50 é uma fração de qualquer alternativa.
Quatro chamadas de API levam um agente de "sem conta" a "cartão pronto para cobrar". Substitua TOKEN pelo seu bearer e CARD_ID pelo inteiro retornado no passo 3.
/.well-known/openapi.json
AI plugin manifest /.well-known/ai-plugin.json
MCP endpoint POST /api/v1/mcp
# Create an anonymous account. Returns seed + Bearer token (ONE TIME). curl -X POST https://cryptotopcard.com/api/v1/auth/signup \ -H "Content-Type: application/json" \ -d '{"name":"my-agent"}'
# Create a top-up: request $100 net in USDT (TRC-20). # Returns the deposit address + exact crypto amount (gross, includes 2% fee). curl -X POST https://cryptotopcard.com/api/v1/topups \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"coin":"USDTTRC","amount":100}' # {... "deposit_address":"T...", "crypto_amount":"102.92", "net_credit_usd":100}
# Once the balance shows the credited amount, issue a card. curl -X POST https://cryptotopcard.com/api/v1/cards \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"bin_id":"471938","amount":150,"label":"meta-acct-7"}' # {... "card_number":"4719 ...", "card_exp":"02/29", "card_cvv":"136"}
# When the card has served its purpose, delete it. Remaining balance refunds instantly. curl -X DELETE https://cryptotopcard.com/api/v1/cards/$CARD_ID \ -H "Authorization: Bearer $TOKEN"
Os mesmos tokens Bearer funcionam no endpoint MCP em /api/v1/mcp. Uma vez configurado, o LLM chama `list_bins`, `create_topup`, `issue_card`, `freeze_card` como ferramentas nativas — sem nenhum wrapper de código necessário.
Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json dentro de mcpServers:
"cryptotopcard": {
"command": "npx",
"args": ["-y", "mcp-remote",
"https://cryptotopcard.com/api/v1/mcp",
"--header", "Authorization:Bearer ctk_live_..."]
}
Nas configurações do seu GPT personalizado, adicione uma Action e importe a especificação OpenAPI:
Import OpenAPI from:
https://cryptotopcard.com/.well-known/openapi.json
Auth: API Key (Bearer)
Nas configurações do Cursor → Features → Model Context Protocol, adicione um novo servidor com transporte HTTP:
HTTP transport:
url: https://cryptotopcard.com/api/v1/mcp
authorization: Bearer ctk_live_...
Depois de conectar, peça ao modelo "emita um cartão Visa Business de US$ 200 financiado com USDT" e ele encadeará `list_bins → list_coins → create_topup → issue_card` automaticamente, exibindo o endereço de depósito e aguardando sua confirmação.
Dezenove rotas no total. Públicas (sem auth) para descoberta + cadastro; todo o resto exige um token Bearer com escopo para sua operação.
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/coins | Lista as 20 criptomoedas suportadas (pública). |
| GET | /api/v1/bins | Lista as 7 categorias de BIN + taxas (pública). |
| POST | /api/v1/auth/signup | Cria uma conta anônima. Retorna a seed + primeiro token de API (única vez). |
| POST | /api/v1/auth/login | Troca uma frase seed por um token de API novo. |
| GET | /api/v1/me | Dados da conta atual: saldo, número de cartões, escopos. |
| POST | /api/v1/topups | Cria uma fatura de depósito em cripto. O cliente paga o valor bruto (incl. taxa de 2%), o líquido é creditado. |
| GET | /api/v1/topups/:id | Obtém o status atual de uma recarga. |
| POST | /api/v1/topups/:id/cancel | Cancela uma recarga pendente (sem efeito se já foi paga). |
| GET | /api/v1/cards | Lista cartões ativos + congelados (somente últimos 4 dígitos). |
| POST | /api/v1/cards | Emite um novo cartão. Debita US$ 1,50 + valor do saldo. |
| GET | /api/v1/cards/:id | Detalhes completos do cartão (PAN, validade, CVV) para um cartão. |
| POST | /api/v1/cards/:id/freeze | Bloqueia todas as cobranças no cartão. Reversível. |
| POST | /api/v1/cards/:id/unfreeze | Reativa um cartão congelado. |
| POST | /api/v1/cards/:id/topup | Move fundos do saldo da conta para o saldo do cartão. |
| DELETE | /api/v1/cards/:id | Encerra um cartão. Reembolsa o saldo restante para a conta instantaneamente. |
| GET | /api/v1/keys | Lista as chaves de API do chamador (apenas metadados, sem o token). |
| POST | /api/v1/keys | Gera uma nova chave de API. Token retornado uma única vez. |
| DELETE | /api/v1/keys/:id | Revoga uma chave de API. |
| POST | /api/v1/mcp | Servidor MCP (JSON-RPC 2.0). Mesma autenticação bearer. |
Cada requisição é autenticada com um token Bearer por usuário (ctk_live_…). Os tokens são hash sha256 em repouso; nunca armazenamos o valor bruto. Cada token carrega uma lista de escopos separados por vírgula (read, topups, cards) — um token sem "cards" não consegue emitir um cartão.
Três escopos disponíveis. O padrão para tokens novos é read,topups,cards — remova escopos ao criar um token (POST /keys com scopes: "read") para limitar o raio de impacto.
read — Endpoints GET (dados da conta, listar cartões, listar recargas).topups — POST /topups, /topups/:id/cancel.cards — POST /cards, /cards/:id/freeze, /cards/:id/unfreeze, /cards/:id/topup, DELETE /cards/:id, GET /cards/:id (sensível).Não existe recuperação por e-mail. A frase seed retornada no cadastro é a única credencial — se perdida, a conta e seu saldo ficam irrecuperáveis. Guarde em um gerenciador de segredos. Rotacione tokens de API à vontade com POST /keys.
Os endpoints públicos funcionam sem conta. O cadastro leva um POST. Teste o quickstart de ponta a ponta antes de integrar.
Ler o início rápido