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 Authorization: Bearer <YOUR_KEY>.

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "recovr": {
      "type": "http",
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "recovr": {
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

VS Code Copilot

Edit .vscode/mcp.json:

{
  "servers": {
    "recovr": {
      "type": "http",
      "url": "https://mcp.paypredict.net/mcp",
      "headers": {
        "Authorization": "Bearer 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 0.1.0 · build unknown