MCP

Connect MCP clients

Use Clerk OAuth for the hosted server or the npm stdio package for local and break-glass operation.

Hosted OAuth setup

The production MCP endpoint uses Streamable HTTP and Clerk OAuth. Add this configuration:

{
  "mcpServers": {
    "liveprobe": {
      "url": "https://liveprobe.tryastrea.tech/mcp"
    }
  }
}

Select Login in the MCP client, authenticate in the browser, and choose an active Clerk organization. The client stores and refreshes the OAuth token. LiveProbe does not ask users to copy a human API key.

Cursor workflow

Open Cursor settings and add the MCP server configuration.
Refresh MCP servers and complete the browser login.
Ask Cursor to run ping_broker.
Select a project and environment, then run list_services.
Create or inspect catalog resources before issuing a runtime credential.

Local stdio fallback

The npm package is intended for local development and the shared-key break-glass path. It requires Node.js 20+.

LIVEPROBE_API_KEY="<operator-key>" \
npx -y @doomslayer2945/liveprobe-mcp@0.4.0 \
  --broker-url https://liveprobe.tryastrea.tech

{
  "mcpServers": {
    "liveprobe": {
      "command": "npx",
      "args": [
        "-y",
        "@doomslayer2945/liveprobe-mcp@0.4.0",
        "--broker-url",
        "https://liveprobe.tryastrea.tech"
      ],
      "env": {
        "LIVEPROBE_API_KEY": "<operator-key>"
      }
    }
  }
}

Authentication errors

Error	Meaning	Action
`unauthorized`	Missing, expired, invalid, or revoked token	Reconnect hosted OAuth or replace the local bearer key
`organization_required`	Clerk session has no active workspace	Select the invited Clerk organization and reconnect
`clerk_session_pending`	Organization enrollment is incomplete	Complete the pending workspace enrollment
`forbidden`	The identity cannot perform that operation	Confirm workspace membership and operation scope
`scope_mismatch`	A service key targeted another scope	Use the project/environment used when issuing the key