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
https://mcpatch.monster13liar.xyz- Requests and responses are JSON, except error bodies, which are plain text (see below).
- Send
content-type: application/jsonon 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 field | Type | Description |
|---|---|---|
url | string, required | The HTTPS connector URL. Up to 2000 characters. |
token | string | A 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. |
headerName | string | Header to send the token in. Default Authorization. Letters, numbers and dashes only. |
previousId | string | The id of your last check of this connector. Used for the tool-change comparison; if omitted, the last check from your address is used. |
curl -sS -X POST https://mcpatch.monster13liar.xyz/api/check \
-H 'content-type: application/json' \
-d '{"url":"https://mcp.example.com/mcp"}'{
"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
| Field | Type | Description |
|---|---|---|
id | string | The report id. The report is at /r/<id> and the JSON at GET /api/check/<id>. |
url | string | The URL as normalised by the checker. |
checkedAt | string | ISO 8601 time of the check. |
durationMs | number | Total time of the run. |
withToken | boolean | Whether you supplied a token. |
platform | string or null | The detected host, such as Vercel, Cloudflare, Render, Railway, Fly.io, Netlify, AWS, Azure, Google Cloud, nginx or an ngrok tunnel. |
verdict | object | status (pass, warn or fail), headline, and stepId when it failed. |
steps | array | Always twelve entries, in order. See below. |
compat | object | status (pass, warn, skip), summary, fix and versions: one entry per protocol version with version, status, ms and sometimes got and note. |
drift | object | status (pass, warn, skip), summary, and when there are changes changes (list of strings), fix and since. |
tools | object | Present when a tool list was read: a compact snapshot used for the comparison, with count and listChanged. |
toolSafety | object | Present when there are tools: status, summary and flags, each with tool, where, severity (high or medium), title, why, ok and snippet. |
A step
| Field | Type | Description |
|---|---|---|
id | string | One of address, dns, tls, edge, handshake, tools, tooldefs, discovery, asmeta, register, authorize, token. |
title | string | The human name of the step. |
status | string | pass warn fail or skip. |
summary | string | What the step saw, in plain words. |
fix | string | What to change. Empty on a pass. |
evidence | string[] | The raw facts: records, headers, excerpts. |
ms | number or null | How long the step took. |
Errors
| Status | Body | Meaning |
|---|---|---|
| 400 | Paste a connector URL | The url field is empty. |
| 400 | Header name can only use letters, numbers and dashes | Bad headerName. |
| 429 | free-limit | The free checks for this address, or for this connector, are used up for 24 hours. |
| 429 | Too many checks. Try again in a few minutes. | More than 12 requests in 10 minutes. |
| 500 | Something went wrong on our side | An 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.
curl -sS https://mcpatch.monster13liar.xyz/api/check/k3Vq8mXb2Yd1#POST /api/vet
Runs the install check on a skill or MCP server.
| Body field | Type | Description |
|---|---|---|
url | string, required | A GitHub repository, folder or file link, an npm package link, an npx command, or any HTTPS file link. Up to 500 characters. |
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 field | Type | Description |
|---|---|---|
id | string | The report id; the page is at /v/<id>. |
status | string | pass, warn or fail. |
headline | string | The summary sentence. |
source | string | What was read, for example owner/repo or name@version (npm). |
flags | array | Findings grouped by rule: rule, severity, title, why, ok and places (file, line, snippet). |
counts | object | How many serious and medium findings, and how many files of each kind were read. |
can | string[] | What the skill is able to do. |
hosts | string[] | Hosts it talks to. |
allowedTools | string[] | 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.