Servidor MCP
Su asistente de IA, en su mesa de reembolsos.
Pregunte a Claude, Cursor o cualquier cliente MCP sobre sus reembolsos en lenguaje común. Lee sus casos y pruebas y, cuando usted lo permite, propone decisiones que llegan a su cola de aprobación.
- HTTP transmisible, JSON-RPC 2.0
- Versiones de protocolo 2025-11-25 y 2026-07-28
- Presupuesto de 10 segundos por llamada
- 11 herramientas, verificadas al iniciar
Para comercios
Lo que hace por su equipo.
Pregunte en vez de buscar
Qué casos esperan, qué dijo el cliente, qué versión de política se aplicó. Las respuestas vienen de su espacio de trabajo, no de una suposición.
Propuestas, no acciones
Las herramientas de escritura solo proponen. Cada propuesta espera a una persona en su cola de aprobación.
Todo queda registrado
Las propuestas y las decisiones humanas sobre ellas van al mismo registro de auditoría que cualquier otro caso.
Herramientas
Once herramientas, siete de solo lectura.
Las herramientas de lectura están activas para cualquier clave de API del espacio de trabajo. Las de propuesta siguen apagadas hasta que se activan para su espacio de trabajo.
Herramientas de lectura
| Herramienta | Qué devuelve |
|---|---|
list_cases | Sus casos, filtrados y paginados. |
get_case | Un caso con su estado, montos y artículos. |
dispute.case_timeline | La cronología ordenada de un caso. |
dispute.evidence_sections | Las secciones de pruebas reunidas para una disputa. |
dispute.shopper_communications | Los mensajes intercambiados con el cliente. |
dispute.policy_version_text | El texto de la versión de política que se aplicó. |
dispute.prior_transaction_summary | Un resumen de las transacciones anteriores del cliente. |
Herramientas de propuesta
Apagadas por defecto. Requieren el complemento External Agent Access (incluido en Scale) y se activan para su espacio de trabajo a solicitud.
| Herramienta | Qué devuelve |
|---|---|
start_case | Propone abrir un caso. |
cancel_case | Propone cancelar un caso. |
submit_evidence | Propone pruebas de disputa para revisión. |
propose_decision | Propone una decisión con justificación, confianza y citas. |
Acceso
Su clave, sus alcances.
Clave de API del espacio de trabajo
Envíela como token bearer. La clave se limita a un espacio de trabajo, y el límite de tasa efectivo es el menor entre el de la clave y el de su plan.
OAuth 2.1
Inicie sesión desde el cliente con PKCE (S256), sin clave que copiar. Los tokens de acceso duran 1 hora y los de actualización 30 días. No se aceptan credenciales de cliente.
| Alcance | Permite |
|---|---|
read | Leer casos, cronologías y pruebas. |
intake | Proponer abrir o cancelar un caso. |
approvals | Proponer pruebas y decisiones. |
Configuración
Conéctese en tres pasos.
01
Cree una clave de API del espacio de trabajo
Cree una clave en el panel, en API y webhooks, y elija sus alcances. Empiece con lectura.
02
Agregue Lumtry a su cliente
El servidor habla MCP por HTTP transmisible en la ruta /mcp de su host de API. Elija su cliente abajo.
03
Pregunte por sus reembolsos
Pruebe: qué aprobaciones tienen más de un día, o por qué el pedido 10442 está en espera.
Reemplace api-host por el host de su API de Lumtry y mantenga la clave fuera de archivos compartidos.
claude mcp add --transport http lumtry https://<api-host>/mcp \
--header "Authorization: Bearer eqk_live_…"{
"mcpServers": {
"lumtry": {
"url": "https://<api-host>/mcp",
"headers": { "Authorization": "Bearer ${env:LUMTRY_API_KEY}" }
}
}
}{
"mcpServers": {
"lumtry": {
"command": "npx",
"args": ["mcp-remote", "https://<api-host>/mcp", "--header", "Authorization:${LUMTRY_AUTH}"],
"env": { "LUMTRY_AUTH": "Bearer eqk_live_…" }
}
}
}POST /mcp
Authorization: Bearer eqk_live_…
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "propose_decision",
"arguments": {
"refund_case_id": "01J9Z3K4M8Q2V6X0B5N7T1R3Y8",
"recommended_decision": "manual_review",
"rationale": "Carrier scan shows delivery; photo shows damage.",
"confidence": 0.72,
"citations": ["dispute.evidence_sections#delivery"]
},
"_meta": { "idempotencyKey": "prop-10442-1" }
}
}Salvaguardas
Lo que su agente nunca puede hacer.
Mover dinero por su cuenta
No hay un canal de decisión autónomo. Una persona aprueba cada propuesta.
Cambiar a dónde va un reembolso
Un agente nunca puede fijar el destino de un reembolso ni cambiar un monto.
Marcar un reembolso como completado
La finalización solo llega del flujo de trabajo tras un resultado real del procesador.
Saltarse sus reglas
Las propuestas siguen pasando por su política fijada y su cola de aprobación.
Preguntas
Preguntas sobre MCP, respondidas.
¿Puede un asistente reembolsar a un cliente por sí solo?
No. Las herramientas de lectura solo leen. Las de propuesta ponen una propuesta en su cola de aprobación, y una persona decide.
¿Qué asistentes funcionan?
Cualquier cliente que hable MCP por HTTP transmisible, incluidos Claude Code, Cursor y Claude Desktop mediante un puente.
¿Necesito OAuth?
No. Una clave de API del espacio de trabajo funciona como token bearer. El inicio de sesión con OAuth 2.1 está disponible a solicitud.
¿Cómo activo las herramientas de propuesta?
Requieren el complemento External Agent Access, incluido en Scale, y se activan para su espacio de trabajo a solicitud. Mientras tanto solo existen las siete herramientas de lectura.
¿Hay límites de tasa?
Sí. El límite efectivo es el menor entre el de su clave y el tope de su plan.
¿Qué puede ver?
Solo el espacio de trabajo al que pertenece la clave o el token, dentro de los alcances que usted otorgó.
Dele a su asistente un lugar en la mesa de reembolsos.
Empiece gratis, cree una clave y conéctese en minutos. Pídanos activar las herramientas de propuesta cuando esté listo.