Wellbore Genius

MCP setup — Cursor & Claude Desktop

Connect your assistant to the Wellbore Genius Model Context Protocol server. Tools run as the signed-in user via Supabase OAuth 2.1, so per-tool scopes and RLS apply.

Server URL

https://wellboregenius.com/mcp

Transport: Streamable HTTP (JSON-RPC). Auth: OAuth 2.1 with dynamic client registration — no manual client ID or secret required.

Claude Desktop

Open Settings → Developer → Edit Config. This opens claude_desktop_config.json.
Add the entry below (merge into any existing mcpServers block):

{
  "mcpServers": {
    "wellbore-genius": {
      "url": "https://wellboregenius.com/mcp"
    }
  }
}

Quit and relaunch Claude Desktop.
A browser tab opens for sign-in. Approve the consent screen — you're returned to Claude and the wellbore-genius tools appear in the tool picker.

Cursor

Open Cursor Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json directly.
Paste:

{
  "mcpServers": {
    "wellbore-genius": {
      "url": "https://wellboregenius.com/mcp"
    }
  }
}

Save. Cursor opens a browser tab for OAuth sign-in.
Approve on the consent screen. The server shows as connected with a green dot in the MCP panel.

Available tools

search_manual — hybrid lexical search over the user manual.
answer_equation_question — structured equation / limitation lookup with deep-link citations.
explain_pressure_signature — classify a Nolte-Smith log(Pnet) vs log(t) slope.
forward_pressure — hydrostatic / ECD / mud-weight window / surface budget from the pressure advisor.

Every call is per-tool rate-limited and audited. Sensitive tools require the pressure:read scope, granted automatically on first consent.

Troubleshooting

Consent screen redirects to the app home instead of back to the client — sign in first at /auth, then re-launch the MCP connection.
401 on every tool call — the OAuth token expired. In Cursor, click Reconnect; in Claude Desktop, remove and re-add the server entry.
Tool returns rate_limited — wait the number of seconds in retryAfterSec and retry. Defaults: 20-30 calls/min for solver tools, 30-60 for read-only search.
Tool returns policy_denied — your account lacks the required role. Ask a workspace admin to grant it.