Agent Payments (MCP)
Infraestructura de pagos para agentes
Infraestructura financiera para agentes autónomos.
Infraestructura compatible con agentes
Orangepill ofrece un servidor Model Context Protocol (MCP) que expone capacidades financieras a agentes con políticas estrictas y preflight checks.
- Descubrir productos y cotizar pagos
- Iniciar compras con idempotencia y auditoría
- Leer balances y ledger de forma segura
Infraestructura financiera de nivel producción
Diseñada para fintechs con orquestación segura y APIs para desarrolladores.
Resumen del servidor MCP
El servidor MCP se identifica como orangepill-payments-mcp y usa autenticación mcp_session_token, con OAuth opcional para agentes ligados a usuarios.
Las sesiones incluyen tenant_id, project_id, agent_id y policy_id para
seguridad multi-tenant estricta.
Identidad MCP
- Servidor: orangepill-payments-mcp
- Auth: mcp_session_token
- Opcional: OAuth para agentes con usuario
Grupos de herramientas MCP
Descubrimiento y cotización
Operaciones seguras sin efectos financieros.
Compra y liquidación
Operaciones comerciales, con liquidación normalmente disparada por el sistema.
Wallet y balances
Lectura de balances por defecto.
Admin e inventario
Acciones privilegiadas con scopes elevados.
Principios de diseño MCP
- Superficie de herramientas pequeña con validación estricta
- Idempotency keys para efectos secundarios
- Campo reason obligatorio para auditoría
- Soporte opcional de dry_run
{
"name": "order_create",
"inputSchema": {
"required": ["items", "currency", "idempotencyKey", "reason"]
}
}Risk preflight
Antes de cualquier acción financiera, los agentes llaman a risk_preflight para recibir
allowed, requires_review o blocked.
Flujo de agente
Políticas de agente
Los agentes operan bajo AgentIdentity y AgentPolicy con límites de gasto, allowlists y controles de riesgo.
Restricciones de política
- Operaciones permitidas
- Límites de gasto
- Merchant allowlists
- Controles de riesgo
{
"tool": "catalog_search",
"query": "event ticket"
}El agente descubre un producto sin efectos financieros.
Ejemplo para desarrolladores
Los agentes descubren productos, crean órdenes e inician checkout mediante herramientas MCP.
const quote = await mcp.checkout_quote({
product_id: "ticket-123",
currency: "COP"
})
const order = await mcp.order_create({
items: [{ product_id: "ticket-123" }],
currency: "COP",
idempotencyKey: "order-123",
reason: "user purchase"
})Infraestructura para comercio con agentes
Orangepill permite delegar acciones financieras a agentes sin exponer los rieles directamente. MCP habilita comercio con políticas y auditoría.