API descriptions

Discover the remote MCP server

GET /mcp/server-card

Returns the public server card when Free or Pro includes remote MCP, or 404 before then. The card names the endpoint and supported protocol versions. It has no tool list. It is cacheable with ETag and supports cross-origin reads without credentials.

Example request

curl --request GET 'https://commitscale.com/mcp/server-card'

Example values illustrate the format. Use your own credentials and identifiers.

Responses

200 The public MCP server card.

application/mcp-server-card+json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "description": "Tools for working on software hosted by Commitscale.",
  "name": "com.commitscale/mcp",
  "remotes": [
    {
      "supportedProtocolVersions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18"
      ],
      "type": "streamable-http",
      "url": "https://example.com/mcp"
    }
  ],
  "title": "Commitscale",
  "version": "0.1.0"
}

$schemarequired · string

The server-card schema URL.

descriptionrequired · string

A short description of the server.

namerequired · string

The server's registered name.

remotesrequired · array of object

The available remote transports.

Fields of remotes

The available remote transports.

Each item has this shape.

supportedProtocolVersionsrequired · array of string: Protocol versions supported by this endpoint.
Fields of supportedProtocolVersions
Protocol versions supported by this endpoint.
Each item has this shape.
typerequired · string: The remote transport type.
urlrequired · string: The remote MCP resource URL.

titlerequired · string

The server's human-readable title.

versionrequired · string

The server's version.

304 The card has not changed.

RateLimit and RateLimit-Policy describe the request rate. Follow Retry-After when a response asks you to wait.

Problem responses

Errors use application/problem+json. Act on the stable code, and follow next when present. See the problem format.

quota_exceeded429

With 429, the caller used its requests for the minute. With 422, a count limit was reached.

With 429, wait Retry-After seconds and retry. With 422, remove one first.

internal500

The server failed, and logged why.

Retry after Retry-After seconds. A write is safe to retry with the same idempotency key.