Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.getovra.com/llms.txt

Use this file to discover all available pages before exploring further.

@ovra/mcp ist der kanonische Weg einem LLM Zahlungsfähigkeit zu geben. Es implementiert das Model Context Protocol und exposed Ovras volle Surface — 19 Tools in drei Gruppen organisiert — über Streamable HTTP und stdio. Tools sind für LLMs designt, nicht für Menschen. Jedes Tool nutzt einen action-Parameter um Operations zu multiplexen (z.B. ovra_card { action: "issue", ... }); Beschreibungen sind für Modell-Konsumption geschrieben; Required-Field-Gating nutzt JSON-Schema if/then damit das Modell klare Errors bekommt.
Heute Sandbox-only. sk_sandbox_* oder sk_test_* Key verwenden. Live-Mode öffnet in v1.3+.

​
Transports

Streamable HTTP

Remote, keine Installation. Best für Production. https://api.getovra.com/api/mcp

Stdio

Lokaler Subprozess via npx @ovra/mcp@latest. Best für Desktop-Clients.

​
Unterstützte Clients

Alles was MCP spricht: Claude Desktop, Claude Code, Cursor, Kiro, OpenAI Agents SDK, LangGraph (via langchain-mcp-adapters), CrewAI, Custom-Clients.

​
Die 19 Tools

​
Agent-Tools (9) — was ein Agent direkt ruft

ToolZweck
ovra_payVoller Payment-Flow — handled 402, Intent, Credential, Present
ovra_intentDeklarieren, get, cancel, verify Intents
ovra_credentialGrant, issue, redeem, revoke Payment-Credentials
ovra_cardIssue, list, freeze, unfreeze, close, rotate Karten
ovra_policyAgent-Policy lesen (read-only — Agents können nicht modifizieren)
ovra_transactionGet, memo
ovra_receiptUpload, retrieve PDF-Receipts (≤5 MB, base64)
ovra_disputeDisputes filen und inspizieren
ovra_outcomePayment-Outcomes für Policy-Learning melden

​
Money-Movement (6) — Wallets, Vendors, Workflows

ToolZweck
ovra_accountWallet get/create/fund
ovra_paymentTransfers — get/create/split
ovra_vendorBeneficiaries — get/create/delete
ovra_workflowMulti-step Payment-Workflows
ovra_authorizationDelegations — create/redeem/revoke
ovra_claimEinzug — Payment-Requests, Links, Invoices (Tool wird in Future-Release zu ovra_collect umbenannt)

​
Admin (4) — Konfiguration, Cross-Cutting

ToolZweck
ovra_agentProvision, get, update Agents; Agent-Tokens verwalten
ovra_customerAccount-Profil + DSGVO (Export, Consent, Delete)
ovra_merchantMCC-Lookup, Merchant-Intelligence (read-only)
ovra_configAPI-Keys (redaktiert) und Webhooks listen
Siehe Tool-Referenz für jede Action und Parameter.

​
Two-Mode-Payment-Flow

User: "Kauf einen USB-C Hub unter EUR 30 auf amazon.de"

Agent wählt basierend auf Merchant-Capabilities:

  MPP-aware Merchant ─► ovra_pay { action: "checkout", ... }   (ein Call)
  Form-only Merchant ─► ovra_pay { action: "handle_402", ... } + CUA-Harness
Für feingranulare Kontrolle ovra_intent + ovra_credential direkt verwenden.

​
Sicherheit

  • Response-Redaktion. Jede Tool-Response geht durch eine Redact-Pass — PAN, CVV, API-Keys, Webhook-Secrets werden maskiert bevor sie in Modell-Kontext gelangen.
  • Confirmation-Gates. Destruktive Aktionen (card.close, gdpr_delete, token_revoke) verlangen explizites confirm: true.
  • Input-Validierung. Required-Parameter via if/then enforced. IDs gegen Path-Traversal sanitized.
  • URL-Validierung. Webhook- und Execute-URLs müssen HTTPS, SSRF-checked sein.
  • Tool-Annotationen. Jedes Tool trägt readOnlyHint, destructiveHint, idempotentHint Metadaten damit MCP-aware Clients User warnen können.

​
Sacred Guarantees durch MCP

  • PAN/CVV können physisch nicht zum Modell — server-seitige Redaktion plus Credential-Grenze.
  • requireIntent server-seitig erzwungen; ein ovra_pay Call ohne approved Intent returnt einen strukturierten Error, niemals eine Charge.
  • Strict Agent-Isolation — at_* Tokens sehen nur eigene Agent-Daten.

​
Weiter

Setup

Installation und Konfiguration für deinen Client.

Tool-Referenz

Jedes Tool, jede Action, jeder Parameter.

Claude Desktop

Der einfachste Client.

OpenAI Agents

Hosted MCP-Integration.