MCP Server

MCP Server

Argentive Card expone un MCP server público en https://mcp.argentive.card/mcp. Cualquier agente compatible con MCP — Claude Desktop/Code, Cursor, OpenCode, ChatGPT con Operator — puede crear cards, pagar en checkouts y gestionar payment methods, todo desde lenguaje natural.

Overview

  • Endpoint: https://mcp.argentive.card/mcp
  • Transportes: stdio (subproceso local vía CLI) o HTTP (remoto con SSE para streaming).
  • Auth: OAuth 2.1 + PKCE para producción, o JWT local de la sesión del CLI argentive auth login.
  • Aislamiento: cada cliente OAuth ve únicamente las cards que él mismo creó. Aislamiento por client_id.

Conectar Claude Desktop

Editá tu config y reiniciá Claude Desktop:

~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "argentive-card": {
      "command": "argentive",
      "args":    ["mcp"]
    }
  }
}

En Windows el path es %APPDATA%\\Claude\\claude_desktop_config.json. En macOS ~/Library/Application Support/Claude/claude_desktop_config.json.

Conectar Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "argentive-card": {
      "url": "https://mcp.argentive.card/mcp",
      "headers": { "Authorization": "Bearer at_..." }
    }
  }
}

Conexión HTTP remota (cualquier MCP client)

El transporte HTTP soporta el flow OAuth 2.1 + PKCE estándar. Tu MCP client se conecta a https://mcp.argentive.card/mcp y la primera vez se abre el browser para autenticar.

discovery (RFC 8414)
GET https://mcp.argentive.card/.well-known/oauth-authorization-server

{
  "issuer":                              "https://mcp.argentive.card",
  "authorization_endpoint":              "https://mcp.argentive.card/authorize",
  "token_endpoint":                      "https://mcp.argentive.card/token",
  "scopes_supported": [
    "cards.read", "cards.write", "cards.details",
    "cardholders.read", "cardholders.write",
    "transactions.read", "webhooks.manage"
  ],
  "response_types_supported":            ["code"],
  "code_challenge_methods_supported":    ["S256"],
  "token_endpoint_auth_methods_supported": ["none"]
}

Ver Autenticación → OAuth para el flow completo con todos los scopes.

Tools disponibles

create_card
Emite una card single-use con un spend limit. Pide aprobación opcional.
Cards
list_cards
Lista cards del cardholder con filtros por status.
Cards
check_balance
Balance restante de una card.
Cards
get_card_details
Devuelve PAN/CVV — acceso AUDITADO. Requiere aprobación humana opcional.
Cards
close_card
Cierra una card. Libera el hold si no fue capturado.
Cards
list_transactions
Histórico de transacciones de una card.
Cards
submit_user_info
Crea el cardholder con datos de KYC.
Cardholder
setup_payment_method
Devuelve checkoutUrl para registrar payment method.
Cardholder
list_payment_methods
Lista los PMs registrados.
Cardholder
set_default_payment_method
Cambia el PM default usado para holds.
Cardholder
remove_payment_method
Elimina un PM (no se puede si hay holds activos).
Cardholder
detect_checkout
Detecta si el browser actual está en un checkout form. Llama a la extensión.
Checkout
fill_card
Le pide a la extensión rellenar el form con una card single-use.
Checkout
pay_checkout
Combina create_card + fill_card en un solo paso.
Checkout
get_plan
Plan actual del usuario y límites.
Plan
upgrade_plan
Cambia de Free a Pro.
Plan
cancel_plan
Cancela el plan, baja a Free al final del ciclo.
Plan
approve_request
Aprueba una solicitud pendiente de aprobación humana.
Approval
start_support_chat
Abre una conversación de soporte con humano.
Soporte
send_support_message
Manda un mensaje en una conversación abierta.
Soporte
read_support_chat
Lee la conversación de soporte.
Soporte

Reglas para el agente

Argentive Card publica un SKILL.md oficial — los agentes que lo respetan tienen una integración más segura. Las reglas mínimas:

  • Confirmar antes de create_card y close_card: son operaciones que mueven plata. Mostrá monto + merchant esperado.
  • Nunca mostrar PAN/CVV proactivamente: solo después de un pedido explícito del usuario o cuando es necesario para autofill.
  • Mostrar montos formateados: USD 25.00, no 2500 cents.
  • Trackear el card_id y approval_id en el contexto de la conversación. Si el user dice "cancelá la última", sabés a cuál se refiere.
  • Fallback a CLI, no a curl directo: si una tool falla, sugerí el comando argentive equivalente. Nunca expongas API keys ni JWTs en la conversación.
SKILL.md oficial
El SKILL.md completo está publicado en https://mcp.argentive.card/skill.md. Si tu agente lo lee al iniciar sesión, tiene todas las reglas de uso seguro y formato de respuesta.

Ejemplo de uso por un agente

conversación
User:   Reservame el vuelo BA-LIM para el 12 de julio
        que sale más barato en Despegar.

Agent:  Encontré Latam BA→LIM para el 12/7 a USD 412.
        Voy a emitir una card de USD 412 y pagar.
        ¿Confirmás? [y/N]

User:   y

Agent:  → create_card(amount_cents=41200, currency="USD",
                       metadata={"site":"despegar","trip":"BA-LIM-2026-07-12"})
        ✓ card_01HW3FNE2R... emitida (USD 412.00)

        → fill_card(card_id="card_01HW3FNE2R...",
                    site="despegar.com.ar")
        ✓ Card autofill OK
        ✓ Despegar respondió 200 — reserva LATAM-78XK confirmada

Agent:  Listo. Reserva LATAM-78XK por USD 412 confirmada para el 12/7.
        La card se cerró automáticamente tras el cobro.