---
title: "Get MCP connection instructions"
method: GET
path: "/api/v1/mcp/connect"
tags: ["Public"]
---

# Get MCP connection instructions

`GET /api/v1/mcp/connect`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/mcp/connect`
- Auth: none declared

Current instructions for connecting a client to the full Proof MCP server. Public, no API key.

The embedded Proof showcase inside a publisher's own MCP server reads this endpoint through its `proof_connect` tool and marks the call with `X-Proof-Surface`, which is what lets showcase traffic be counted apart from everything else.

## Headers

- `X-Proof-Surface` string: Calling surface, counted separately when it names the showcase.

## Response `200`

Connection instructions

- McpConnectInfo
  - `message` string, required: Human-readable description of what the full Proof MCP server adds to a client.
  - `remote_url` string, uri: The hosted MCP server's own URL. Needs no install and no API key to start — the client authenticates through OAuth when a tool first requires an account. ABSENT where this deployment serves no hosted server; use install_command then.
  - `remote_config` object: Drop-in fragment for connecting a client to the hosted server. Absent together with remote_url.
    - `mcpServers` object, required
      - `proof` object, required
        - `type` string, required
        - `url` string, uri, required
  - `install_command` string, required
  - `install_caveat` string, required: Why a client that resolved an older published build should not rely on it. Names the versions it is about rather than the registry’s present contents, and the remedy it offers depends on the deployment: remote_url where a hosted server is advertised, a later release of the package where none is.
  - `client_config` object, required: Drop-in fragment for a client's MCP server configuration.
    - `mcpServers` object, required
      - `proof` object, required
        - `command` string, required
        - `args` string[], required
  - `docs_url` string, uri, required

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)