Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

headlesson

REMOTE · MCP.HEADLESSON.COM

Find and compare headless apps (CLI, MCP, API) for agents, with sources, lessons and changes.

+2 this week 68 Trust /100

Last scanned (2 hours ago)

Scores higher than 57% of remote servers

Reachable. Last reached 17 Oct 2026.

Category Developer Tools

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security63
Transport & Reachability100
Schema Quality & AI Usability64
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1073 tokens (~268/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
  • Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 16 Oct 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Oct 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

  • 13 Oct 26 0
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “headlesson_get” rewrote its description, which is the text the model reads security
    • Tool “headlesson_search” rewrote its description, which is the text the model reads security
    • Tool “headlesson_whats_new” rewrote its description, which is the text the model reads security
    • Tool “headlesson_get” changed its title: Get a headlesson record → Get tried steps, test results and pitfalls cosmetic
    • Tool “headlesson_search” changed its title: Search headless apps → Find tested tools for a task cosmetic
    • Tool “headlesson_whats_new” changed its title: What changed since a date → Changes in agent tools since a date cosmetic
  • 12 Oct 26 0
    • Tool “headlesson_get” rewrote its description, which is the text the model reads security
    • Tool “headlesson_search” rewrote its description, which is the text the model reads security
    • Schema quality: 167 → 247 ▼ functional
    • Stability: unverified → 0.07 ▲ functional
    • Schema quality: good → excellent functional
    • “headlesson_search” added an optional parameter “include” cosmetic
    • “headlesson_search” reworded the description of “ids” cosmetic
    • “headlesson_search” reworded the description of “query” cosmetic
  • 10 Oct 26 66

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 17 Oct 2026 · Probed https://mcp.headlesson.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=headlesson.com CN=WE1,O=Google Trust Services,C=US 9 Oct 2026 7 Jan 2027 ECDSA 256 ECDSA-SHA256 b0042f02e68c3a7c1358e424b0c27fce
SANs: headlesson.com, mcp.headlesson.com, *.mcp.headlesson.com
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of mcp.headlesson.com. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
headlesson.com. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://mcp.headlesson.com/mcp Verified 200
http (plaintext) http://mcp.headlesson.com/mcp Inconclusive 400
MCP tools · 4 exposed · ~971 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
headlesson_feedback ~155

This content is sent to the headlesson operator. Feedback about headlesson itself is sufficient. Do not include personal information or conversation contents.

NameTypeReqDescription
aboutstring–Optional record ID that the feedback concerns; feedback about headlesson itself needs no product ID.
clientstring–Optional client name only; do not include full User-Agent, account IDs or credentials.
kindstring–Report type: comment, worked, failed, missing or tip; receipt does not verify the claim.
modelstring–Optional model name associated with the report, without conversation content.
textstringyesFeedback to the headlesson operator, 1–2000 Unicode characters; exclude personal information and conversation text.

No output schema declared.

No examples provided.

headlesson_get ~196

Get one record by an ID from headlesson_search: an app, usecase, feature, concept or change. For an app, sections ["lesson","gotchas"] return the install, check and first-task steps with the recorded test result (a dated observation by the headlesson operator) and known failure conditions; "relations" lists alternatives and what it wraps or depends on; "axes" returns every compared fact. Without sections you get the description, interfaces and six main axes. Each fact carries its source and check date; private sources appear as labels, not links. Official MCP Registry listing IDs are fetched live and are unverified; a failed lookup does not prove the ID absent.

NameTypeReqDescription
idstringyesRecord ID or the special axes/search-guide ID; missing records return nearby ID suggestions.
sectionsarray–App sections to return in text and structuredContent; omitted means description, interfaces and six major axes.

No output schema declared.

No examples provided.

headlesson_search ~462

Find command-line tools, MCP servers and APIs for a task, and compare them. Ask in plain English or Japanese ("extract text from scanned PDFs") or by product name. Each result gives an ID, a one-line reason it matches, and when it was checked. Pass the ID to headlesson_get with sections ["lesson","gotchas"] to get the steps (install, check, first task) with their recorded test result (most were run by an agent; a few are untested) and known failure conditions, such as a tool that exits 0 with empty or wrong output. Filter or compare with axes such as auth, pricing, license and remote_mcp (where, axes, ids). Curated records come first. If none match, or include:["registry"] is set, one public word from the query is looked up in the Official MCP Registry; those listings are unverified (what is sent is described on the query field).

NameTypeReqDescription
axesarray–Axes to compare: auth, pricing, license, cli, local_mcp, remote_mcp are useful starting points; licence is normalized to license.
idsarray–Up to 20 explicit app IDs to compare; any missing ID produces an error instead of being silently omitted.
includearray–Explicitly request the supplemental Official Registry name lookup alongside curated results. Otherwise it is attempted only when curated matches are absent. At most five unverified listings; one-page…
limitinteger–Maximum app results, from 1 to 20; default is 5.
querystring–Task or product name in English or Japanese. External Registry lookup sends only one ASCII public name fragment (longest significant ASCII word from free text, or a supplied namespace; max 200 chars)…
sortobject–Optional axis ordering before relevance; unknown values remain last.
whereobject–Confirmed axis filters: AND across axes, OR inside a value array; known spelling aliases are normalized.

No output schema declared.

No examples provided.

headlesson_whats_new ~158

List dated changes in agent tools and standards (new tools, renames, deprecations, breaking changes, new standards) since a date, optionally by kind or affected record. Useful for checking what changed after your training data. Public source URLs are kept; private sources appear as labels.

NameTypeReqDescription
aboutstring–Affected record ID to filter changes, such as an app or protocol.
kindsarray–Change kinds to include; the array is an OR-list.
limitinteger–Maximum changes, from 1 to 100; default is 20.
sincestring–Inclusive event-date lower bound in YYYY-MM-DD; omitted uses the previous 90 days, not source confirmation dates.

No output schema declared.

No examples provided.

Install

How do I install the headlesson MCP server?

headlesson is a hosted endpoint at https://mcp.headlesson.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · mcp.headlesson.com

# add to Claude Code
claude mcp add --transport http com-headlesson-catalog 'https://mcp.headlesson.com/mcp'
Common questions

What is the headlesson MCP server?

headlesson is an MCP server listed in the public MCP registry as com.headlesson/catalog. Find and compare headless apps (CLI, MCP, API) for agents, with sources, lessons and changes. This page covers its hosted endpoint (https://mcp.headlesson.com/mcp).

Is the headlesson MCP server safe to use?

headlesson scores 68 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the headlesson MCP server expose?

headlesson exposes 4 tools: headlesson_search, headlesson_get, headlesson_whats_new, headlesson_feedback. Their descriptions and schemas cost roughly 971 tokens of context every time the server is loaded.

Does the headlesson MCP server require authentication?

No. We connected to headlesson without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the headlesson MCP server still maintained?

headlesson is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.