MCP Overview
Orangepill exposes an MCP server named orangepill-payments-mcp for agent-compatible financial infrastructure.
Agents use tool calls to discover products, quote payments, and initiate purchases with policy enforcement.
Agent conversation
Find tickets for the event tonight.
I found a ticket available for 50,000 COP.
catalog_search
{
"tool": "catalog_search",
"query": "event ticket"
}Agent discovers a product without financial side effects.
Bre-BCardWallet
Infrastructure flow
Agent
MCP server
Orangepill Financial OS
Financial Rails
Agents never call payment rails directly. Orangepill MCP enforces policies, preflight checks, and safe orchestration.
Continue with the agent security model and the tool reference.
Authentication
Use mcp_session_token for session authentication. Optional OAuth is supported for user-bound agents.
Sessions include:
- tenant_id
- project_id
- agent_id
- policy_id
Risk preflight
Agents must call risk_preflight before financial actions. Responses include:
- allowed
- requires_review
- blocked
Tool groups
Tools are grouped into discovery, purchase, wallet access, and admin scopes.