Skip to main content
@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

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

​
Admin (4) — Konfiguration, Cross-Cutting

Siehe Tool-Referenz für jede Action und Parameter.

​
Two-Mode-Payment-Flow

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.