Skip to main content

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.

Claude Desktop speaks MCP natively. Add Ovra and the chat window picks up 19 ovra_* tools.
Sandbox-only today. Use a sk_sandbox_* or sk_test_* key.

​
Where the config lives

OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "ovra": {
      "type": "streamable-http",
      "url": "https://api.getovra.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_sandbox_..."
      }
    }
  }
}

​
Stdio (local subprocess)

{
  "mcpServers": {
    "ovra": {
      "command": "npx",
      "args": ["@ovra/mcp@latest"],
      "env": {
        "OVRA_API_KEY": "sk_sandbox_..."
      }
    }
  }
}
Restart Claude Desktop. The tool menu should now list 19 ovra_* tools.

​
Examples

“Show me my agents and what they’ve spent in the last 30 days.”
Claude calls ovra_agent { action: "get" } and ovra_transaction { action: "get" }, replies with a summary.
“Buy a domain on namecheap.com for my-project.dev”
Claude calls ovra_pay { action: "checkout", agentId, purpose, amount, merchant } and reports the transaction ID.
“Would a EUR 500 purchase at amazon.de be allowed for my procurement agent?”
Claude calls ovra_policy { action: "get", agentId } and explains the limit.
“Open a dispute on tx_abc — package never arrived.”
Claude calls ovra_dispute { action: "file", transactionId: "tx_abc", reason: "not_received" }. Plan-tier-gated (Business+).
ToolPurpose
ovra_payFull payment flow
ovra_agentList agents, check status
ovra_intentDeclare and verify
ovra_credentialFine-grained credential lifecycle
ovra_transactionHistory + memo
ovra_policyRead spending limits
ovra_configInspect API keys + webhooks (read-only)

​
Troubleshooting

  • Tools don’t appear: quit and relaunch Claude Desktop fully — re-loading from the menu doesn’t refresh MCP servers.
  • Auth errors: GET /keys to confirm the key isn’t revoked. If you rotated, update the config.
  • Sandbox confusion: every Ovra response carries X-Ovra-Mode: test|live. In sandbox you’ll always see test.

​
Next

MCP setup

Other clients and advanced config.

MCP tools

Every action and parameter.

Quickstart

Five-minute end-to-end run.