Claude Desktop

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

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Streamable HTTP (recommended)

{
  "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

Check spending

“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.

Make a purchase

“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.

Inspect policy

“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.

File a dispute

“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+).

Recommended tools

Tool	Purpose
`ovra_pay`	Full payment flow
`ovra_agent`	List agents, check status
`ovra_intent`	Declare and verify
`ovra_credential`	Fine-grained credential lifecycle
`ovra_transaction`	History + memo
`ovra_policy`	Read spending limits
`ovra_config`	Inspect 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.

MCP setup

Other clients and advanced config.

MCP tools

Every action and parameter.

Quickstart

Five-minute end-to-end run.

Agent Frameworks

Claude Desktop

Where the config lives

Streamable HTTP (recommended)

Stdio (local subprocess)

Examples

Recommended tools

Troubleshooting

Next

MCP setup

MCP tools

Quickstart

​Where the config lives

​Streamable HTTP (recommended)

​Stdio (local subprocess)

​Examples

​Recommended tools

​Troubleshooting

​Next

MCP setup

MCP tools

Quickstart

Where the config lives

Streamable HTTP (recommended)

Stdio (local subprocess)

Examples

Recommended tools

Troubleshooting

Next