Una superficie API REST + MCP diseñada para agentes autónomos. Regístrate, recarga con cripto y emite tarjetas en 4 llamadas: sin intervención humana, sin KYC, con scopes por clave y límites de tasa completos.
Los endpoints son la base; los patrones son lo que los constructores de agentes realmente lanzan.
Agentes que deciden qué comprar y ejecutan la compra sin aprobación humana. La API emite una tarjeta nueva por transacción, la cobra y la elimina, sin dejar ninguna superficie de pago reutilizable.
Emisión programática de una tarjeta BIN-471938 (Visa Business) por cada cuenta publicitaria de Meta / Google / TikTok. Rota las tarjetas cada 30-60 días para mantener las cuentas limpias.
Marketplaces o plataformas que necesitan una tarjeta única por transacción de usuario final. Emite, cobra y elimina en menos de 10 segundos: sin alcance PCI, sin carga de almacenamiento de tarjetas.
Date de alta en pruebas gratuitas a escala. Cada prueba recibe una tarjeta con la carga mínima; eliminarla antes de la renovación bloquea el cobro automático de forma limpia.
Agentes multi-tenant que facturan SaaS upstream (AWS, OpenAI, Cloudflare, GitHub) con una tarjeta por workspace. Los costes se imputan al cliente sin filtrar tu identidad de facturación maestra.
Cada worker solicita una tarjeta vía API justo cuando necesita una superficie de pago, la usa para la acción prevista y la cierra. El coste unitario de 1,50 $ es una fracción de cualquier alternativa.
Cuatro llamadas a la API llevan a un agente de "sin cuenta" a "tarjeta lista para cobrar". Sustituye TOKEN por tu bearer y CARD_ID por el entero devuelto en el paso 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"
Los mismos tokens Bearer funcionan en el endpoint MCP en /api/v1/mcp. Una vez configurado, el LLM llama a `list_bins`, `create_topup`, `issue_card`, `freeze_card` como herramientas nativas, sin envoltorio de código.
Añade en ~/Library/Application Support/Claude/claude_desktop_config.json bajo mcpServers:
"cryptotopcard": {
"command": "npx",
"args": ["-y", "mcp-remote",
"https://cryptotopcard.com/api/v1/mcp",
"--header", "Authorization:Bearer ctk_live_..."]
}
En los ajustes de tu GPT personalizado, añade una Action e importa la spec OpenAPI:
Import OpenAPI from:
https://cryptotopcard.com/.well-known/openapi.json
Auth: API Key (Bearer)
En Cursor: Settings → Features → Model Context Protocol, añade un servidor nuevo con transporte HTTP:
HTTP transport:
url: https://cryptotopcard.com/api/v1/mcp
authorization: Bearer ctk_live_...
Tras conectar, pide al modelo "emite una tarjeta Visa Business de 200 $ financiada con USDT" y encadenará `list_bins → list_coins → create_topup → issue_card` automáticamente, mostrando la dirección de depósito y esperando tu confirmación.
Diecinueve rutas en total. Públicas (sin auth) para descubrimiento + registro; el resto requiere un token Bearer con scope acorde a su operación.
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/coins | Lista las 20 criptomonedas compatibles (público). |
| GET | /api/v1/bins | Lista los 7 niveles de BIN + comisiones (público). |
| POST | /api/v1/auth/signup | Crea una cuenta anónima. Devuelve la seed + el primer token API (una sola vez). |
| POST | /api/v1/auth/login | Canjea una frase seed por un token API nuevo. |
| GET | /api/v1/me | Info de la cuenta actual: saldo, número de tarjetas, scopes. |
| POST | /api/v1/topups | Crea una factura de depósito en cripto. El cliente paga el bruto (incl. 2 % de comisión), se acredita el neto. |
| GET | /api/v1/topups/:id | Obtén el estado actual de una recarga. |
| POST | /api/v1/topups/:id/cancel | Cancela una recarga pendiente (sin efecto una vez pagada). |
| GET | /api/v1/cards | Lista las tarjetas activas + congeladas (solo last4). |
| POST | /api/v1/cards | Emite una tarjeta nueva. Debita 1,50 $ + importe del saldo. |
| GET | /api/v1/cards/:id | Datos completos de la tarjeta (PAN, exp, CVV) para una tarjeta. |
| POST | /api/v1/cards/:id/freeze | Bloquea todos los cargos en la tarjeta. Reversible. |
| POST | /api/v1/cards/:id/unfreeze | Reactiva una tarjeta congelada. |
| POST | /api/v1/cards/:id/topup | Mueve fondos del saldo de la cuenta al saldo de la tarjeta. |
| DELETE | /api/v1/cards/:id | Cierra una tarjeta. Reembolsa el saldo restante a la cuenta al instante. |
| GET | /api/v1/keys | Lista las claves API de quien llama (solo metadatos, sin token). |
| POST | /api/v1/keys | Genera una nueva clave API. El token se devuelve una sola vez. |
| DELETE | /api/v1/keys/:id | Revoca una clave API. |
| POST | /api/v1/mcp | Servidor MCP (JSON-RPC 2.0). Misma autenticación bearer. |
Cada petición se autentica con un token Bearer por usuario (ctk_live_…). Los tokens se almacenan con hash sha256; nunca guardamos el valor en claro. Cada token lleva una lista de scopes separados por comas (read, topups, cards): un token sin "cards" no puede emitir una tarjeta.
Tres scopes disponibles. El predeterminado para tokens nuevos es read,topups,cards: reduce scopes al crear un token (POST /keys con scopes: "read") para limitar el radio de impacto.
read — Endpoints GET (info de cuenta, listar tarjetas, 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 (sensible).No hay recuperación por email. La frase seed que se devuelve al registrarse es la única credencial: si se pierde, la cuenta y su saldo son irrecuperables. Guárdala en un gestor de secretos. Rota tokens API libremente con POST /keys.
Los endpoints públicos funcionan sin cuenta. El registro es un POST. Prueba el quickstart de principio a fin antes de integrar.
Leer el inicio rápido