54ch10 MCP server

Thin Model Context Protocol wrapper around the 54ch10 live HTTPS API.

• Live API base: https://54ch10.uk
• Brief: https://54ch10.uk/v1/brief?type=address|token|url&q=...
• Toolkit: /v1/whois, /v1/dns, /v1/tls, /v1/normalize-url, hash, encode, fetch, paste
• Free/demo: header X-54ch10-Free: 1 or /v1/<tool>/free siblings
• OpenAPI: https://54ch10.uk/openapi.json
• x402 discovery: https://54ch10.uk/.well-known/x402
• Brand: 54ch10
• Analytics-only — informational heuristics, not financial, legal, or investment advice. Not clearance.

Exposes five tools: brief, whois, dns, tls, normalize-url.

Field	Value
package name	54ch10-mcp
MCP registry name (mcpName)	io.github.sachio222/54ch10-mcp
Manifest	server.json
Primary install (today)	npx -y github:sachio222/54ch10-mcp

Install / run

Requires Node.js 18+.

Primary (works today)

No public npmjs package yet. Install from the public GitHub repo:

npx -y github:sachio222/54ch10-mcp

Or as a git dependency:

npm install github:sachio222/54ch10-mcp

Claude Desktop / Cursor — see CONFIG.example.json:

{
  "mcpServers": {
    "54ch10": {
      "command": "npx",
      "args": ["-y", "github:sachio222/54ch10-mcp"],
      "env": {
        "BRIEF_API_BASE": "https://54ch10.uk",
        "BRIEF_API_KEY": ""
      }
    }
  }
}

GitHub Packages (not primary)

GitHub Packages npm only supports scoped packages (@sachio222/...). Consumers need @sachio222:registry=https://npm.pkg.github.com and auth. Not a drop-in for unscoped agent installs, so not primary.

npmjs.org (not published)

54ch10-mcp is not on registry.npmjs.org yet (404). Do not rely on npx 54ch10-mcp until a future publish.

From this directory (local)

1. npm install (see package.json).
2. npm start or node src/index.js

The process speaks MCP over stdio. Hosts spawn it; do not expect interactive terminal output.

Env	Purpose
BRIEF_API_BASE	Override API base (default https://54ch10.uk)
BRIEF_API_KEY	Optional paid key. Empty — wrapper sends X-54ch10-Free: 1

Smoke (free header on each tool): GET https://54ch10.uk/v1/brief?type=url&q=https://example.com — also /v1/whois?domain=, /v1/dns?domain=, /v1/tls?domain=, /v1/normalize-url?q= with header X-54ch10-Free: 1

Optional: use the inspect script in package.json with the MCP Inspector.

Tools

brief

Arg	Type	Required	Description
type	address / token / url	yes	What to brief
q	string	yes	Address, token id/symbol, or URL

Returns score, band, flags, summary, sources, disclaimer.

whois

Arg	Type	Required	Description
domain	string	yes	Domain name (e.g. example.com)

RDAP registration / registrar / age_days. Path: GET /v1/whois.

dns

Arg	Type	Required	Description
domain	string	yes	Domain name

A/AAAA/MX/NS + fraud-signal flags. Path: GET /v1/dns.

tls

Arg	Type	Required	Description
domain	string	yes	Domain name

CT issuer / validity + HTTPS reachability. Path: GET /v1/tls.

normalize-url

Arg	Type	Required	Description
q	string	yes	URL to canonicalize

Scheme/host normalize, fragment strip, query sort. Path: GET /v1/normalize-url.

Auth / payments

1. Free/demo — leave BRIEF_API_KEY empty (wrapper uses X-54ch10-Free: 1, 20/UTC-day/IP shared).
2. Stripe — set BRIEF_API_KEY after Checkout claim.
3. x402 (HTTP API) — call https://54ch10.uk/v1/<tool> with USDC pay-per-call. This stdio wrapper does not auto-pay; use x402 client libs against HTTP, or a Stripe key here.

Tool	Indicative x402 price (USDC)
brief	$0.01
whois	$0.005
dns	$0.002
tls	$0.005
normalize-url	$0.001

Discovery: https://54ch10.uk/.well-known/x402

Registry listing checklist

Local prep (this folder):

• [x] Live HTTPS tool target
• [x] Tools: brief + whois + dns + tls + normalize-url
• [x] package.json name 54ch10-mcp + mcpName = io.github.sachio222/54ch10-mcp
• [x] server.json matching mcpName
• [x] CONFIG.example.json + README (github: primary install)
• [x] Public GitHub repo https://github.com/sachio222/54ch10-mcp
• [ ] Public npmjs 54ch10-mcp — not published yet
• [ ] Official MCP Registry — blocked until npmjs package exists (npm registryType = registry.npmjs.org only)
• [ ] After npmjs is public: mcp-publisher login github, then publish

Also: mcp.so / Smithery / awesome-mcp-servers PRs as sachio222 after the package is on npmjs.

Do not Discord/X auto-post.

Disclaimer

Informational tooling only. Not financial, investment, legal, or tax advice. Full text: https://54ch10.uk/LEGAL_DISCLAIMER.txt