Developer guide

API reference

The same check the website runs, over HTTP, so you can call it from a script, a deploy hook or CI.

#Base URL and conventions

text
https://mcpatch.monster13liar.xyz
  • Requests and responses are JSON, except error bodies, which are plain text (see below).
  • Send content-type: application/json on POST requests. Bodies over 64 KB are rejected.
  • Responses are not cacheable. A check takes a few seconds, up to about a minute for a very slow server.
  • The checker runs requests from our server on the public internet and refuses private and reserved addresses.

#POST /api/check

Runs the twelve-step check, the protocol version test, the tool-change comparison and the tool-description scan.

Body fieldTypeDescription
urlstring, requiredThe HTTPS connector URL. Up to 2000 characters.
tokenstringA fixed token or API key, used for this one run and never stored. Without it, sign-in servers are tested up to the token endpoint.
headerNamestringHeader to send the token in. Default Authorization. Letters, numbers and dashes only.
previousIdstringThe id of your last check of this connector. Used for the tool-change comparison; if omitted, the last check from your address is used.
Request
curl -sS -X POST https://mcpatch.monster13liar.xyz/api/check \
  -H 'content-type: application/json' \
  -d '{"url":"https://mcp.example.com/mcp"}'
Response (shortened)
{
  "id": "k3Vq8mXb2Yd1",
  "url": "https://mcp.example.com/mcp",
  "checkedAt": "2026-10-30T16:20:05.311Z",
  "durationMs": 1870,
  "withToken": false,
  "platform": "Vercel",
  "verdict": {
    "status": "fail",
    "stepId": "handshake",
    "headline": "Claude would stop at: MCP handshake"
  },
  "steps": [
    {
      "id": "dns",
      "title": "Public DNS",
      "status": "pass",
      "summary": "Resolves to public IPv4 (76.76.21.21).",
      "fix": "",
      "evidence": ["A: 76.76.21.21"],
      "ms": 18
    },
    {
      "id": "handshake",
      "title": "MCP handshake",
      "status": "fail",
      "summary": "Nothing answers MCP requests at this path (404).",
      "fix": "Use the exact path your MCP server mounts (often /mcp). ...",
      "evidence": ["Body: ..."],
      "ms": null
    }
  ],
  "compat": { "status": "skip", "summary": "Skipped: fix the handshake first.", "versions": [] },
  "drift": { "status": "skip", "summary": "No tool list this time, so there is nothing to compare." }
}

The result object

FieldTypeDescription
idstringThe report id. The report is at /r/<id> and the JSON at GET /api/check/<id>.
urlstringThe URL as normalised by the checker.
checkedAtstringISO 8601 time of the check.
durationMsnumberTotal time of the run.
withTokenbooleanWhether you supplied a token.
platformstring or nullThe detected host, such as Vercel, Cloudflare, Render, Railway, Fly.io, Netlify, AWS, Azure, Google Cloud, nginx or an ngrok tunnel.
verdictobjectstatus (pass, warn or fail), headline, and stepId when it failed.
stepsarrayAlways twelve entries, in order. See below.
compatobjectstatus (pass, warn, skip), summary, fix and versions: one entry per protocol version with version, status, ms and sometimes got and note.
driftobjectstatus (pass, warn, skip), summary, and when there are changes changes (list of strings), fix and since.
toolsobjectPresent when a tool list was read: a compact snapshot used for the comparison, with count and listChanged.
toolSafetyobjectPresent when there are tools: status, summary and flags, each with tool, where, severity (high or medium), title, why, ok and snippet.

A step

FieldTypeDescription
idstringOne of address, dns, tls, edge, handshake, tools, tooldefs, discovery, asmeta, register, authorize, token.
titlestringThe human name of the step.
statusstringpass warn fail or skip.
summarystringWhat the step saw, in plain words.
fixstringWhat to change. Empty on a pass.
evidencestring[]The raw facts: records, headers, excerpts.
msnumber or nullHow long the step took.

Errors

StatusBodyMeaning
400Paste a connector URLThe url field is empty.
400Header name can only use letters, numbers and dashesBad headerName.
429free-limitThe free checks for this address, or for this connector, are used up for 24 hours.
429Too many checks. Try again in a few minutes.More than 12 requests in 10 minutes.
500Something went wrong on our sideAn unexpected error. Try again.

A check that finds a problem is not an error: it returns 200 with verdict.status of fail.

#GET /api/check/:id

Returns the saved result of an earlier check, in the same shape as above. Works for the ids that connector checks and install checks return. 404 with Not found for an unknown id.

bash
curl -sS https://mcpatch.monster13liar.xyz/api/check/k3Vq8mXb2Yd1

#POST /api/vet

Runs the install check on a skill or MCP server.

Body fieldTypeDescription
urlstring, requiredA GitHub repository, folder or file link, an npm package link, an npx command, or any HTTPS file link. Up to 500 characters.
Request
curl -sS -X POST https://mcpatch.monster13liar.xyz/api/vet \
  -H 'content-type: application/json' \
  -d '{"url":"https://github.com/owner/repo/tree/main/skills/name"}'
Response fieldTypeDescription
idstringThe report id; the page is at /v/<id>.
statusstringpass, warn or fail.
headlinestringThe summary sentence.
sourcestringWhat was read, for example owner/repo or name@version (npm).
flagsarrayFindings grouped by rule: rule, severity, title, why, ok and places (file, line, snippet).
countsobjectHow many serious and medium findings, and how many files of each kind were read.
canstring[]What the skill is able to do.
hostsstring[]Hosts it talks to.
allowedToolsstring[]Tools it asks permission to use.

Errors are plain text: 400 with a message such as "Paste a GitHub link..." or "Not found. Check the link, and that the repository or package is public.", 429 for the request rate limit, and 502 when the download timed out.

#GET /api/plans

The plans that can be bought right now: id, name, price in US dollars, period (month or once), endpoints (connector slots) and open.

#GET /api/health

Returns { "ok": true } when the service is up.