Documentation

MCP server

The Sgovr MCP server is an SSE server that exposes Sgovr as a handful of MCP tools. Point any MCP host at the SSE endpoint and every registered provider becomes callable at once, with no per-provider setup.

The tools

The server exposes five tools. The intended agent loop for free actions is sgovr_discover → sgovr_get_spec → sgovr_invoke. Transactional actions add a quote step: sgovr_discover → sgovr_get_spec → sgovr_get_quote → sgovr_invoke.

sgovr_discover - find provider actions matching a natural-language intent.
sgovr_get_spec - read an action's input/output schema, pricing and scopes.
sgovr_get_quote - request a merchant-signed CartMandate for a transactional action; the response includes the provider-confirmed price before any money moves.
sgovr_invoke - invoke an action under the mandate (authorize, settle, audit). Pass intentCredential for free actions; add cartMandate and paymentMandate for transactional AP2 calls.
sgovr_refund - refund a settled transaction (needs the payments:refund scope).

Pre-release

The Python SDK is not yet published to PyPI. The install command below shows the intended form once the first release lands; until then, use the SDK directly from the Sgovr source. Package names may change before 1.0.

1. Register the server

The server is already running - just give your MCP host the SSE endpoint.

Claude Code - add it from the CLI:

terminal

claude mcp add sgovr-sse https://mcp.sgovr.eu/sse

Claude Desktop - its config file only accepts stdio servers, so bridge the SSE endpoint through mcp-remote. Add an entry to your claude_desktop_config.json and restart the app:

claude_desktop_config.json

{
  "mcpServers": {
    "sgovr-sse": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.sgovr.eu/sse"]
    }
  }
}

2. Try it

Ask your agent something like "find me a hotel room in Lisbon and book it." It will chain sgovr_discover → sgovr_get_spec → sgovr_invoke, reserving and settling the booking under your mandate. To learn what each action accepts, see the capability spec.

PreviousPython SDK NextCapability spec