Recovr MCP Server

Customer-scoped healthcare claim data access via the Model Context Protocol.

Overview

This server exposes Recovr's claim, eligibility, discovery, and Optum recon ticket data as MCP tools, resources, and prompts. Connect any MCP-aware client (Claude Desktop, Cursor, VS Code Copilot, Pydantic AI agents, etc.) to the endpoint below using your issued API key.

Capabilities exposed:

• Read tools — firestore_get, firestore_exists, firestore_list, firestore_query, firestore_count, firestore_paginate, firestore_list_collections.
• Write tools — firestore_write, firestore_write_batch.
• Destructive tools (gated) — firestore_archive, firestore_delete. Unlocked per-session via the request_delete_permission prompt.
• Resources — guides, schemas, and customer info under recovr://... URIs.
• Skills — reusable workflow templates under skill://... URIs (e.g. Optum recon ticket dashboards).

Get an API key

API keys are issued by a Recovr administrator via the IAM-gated recovr-mcp-minter service. Contact your account manager or the engineering team to request a key. You will receive a token of the form mcp_live_… shown once; store it securely (e.g. 1Password, secrets-manager) — it cannot be retrieved later.

Installation

This server speaks streamable HTTP. The endpoint is:

https://mcp.paypredict.net/mcp

Authenticate with x-api-key: <YOUR_KEY> — the key itself, with no scheme prefix. This is the only credential header the server reads; Authorization: Bearer is not accepted.

Claude.ai / Claude web

Add a custom connector pointing at the URL above. Under Authentication choose None, then add one request header: name x-api-key, value your key, marked Required. Claude sends the value verbatim.

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "recovr": {
      "type": "http",
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json (per-project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "recovr": {
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

VS Code Copilot

Edit .vscode/mcp.json:

{
  "servers": {
    "recovr": {
      "type": "http",
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Verify your setup

• GET /health — liveness probe (no auth required).
• GET /.well-known/oauth-protected-resource — OAuth 2.1 protected-resource metadata (RFC 9728).
• GET /version — service version and build info.
• GET /docs — full reference (mirrors the recovr://help MCP resource).

Once connected, ask your client to read the recovr://help resource for the full provider map, then recovr://customer/info to confirm your scopes.

Resources

• Reference (markdown)
• Source code

Recovr MCP Server · version 5.0.0 · build unknown