Agent Ready

NPM · AGENT-READY-MCP · 2 COMPONENTS · SCANNED AUG 4

Scan any URL for AI agent readability — Vercel Spec, llmstxt.org, and agent-protocol manifests.

Available components

remote · agent-ready.dev 83 npm · agent-ready-mcp 80

+4 this week 80 80 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security83

No malware found by supply-chain analysis.Pass
CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available. View diagnostics → Fail
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Cryptographically verified build provenance (signed, bound to mlava/agent-ready-mcp). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 4 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability83

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 931 tokens (~116/item across 8 items; 4 tools + 4 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 Management27

Stability observed for 8 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
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · agent-ready-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add mlava-agent-ready-mcp -- npx -y agent-ready-mcp

# add to Codex CLI

codex mcp add mlava-agent-ready-mcp -- npx -y agent-ready-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mlava-agent-ready-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "agent-ready-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add mlava-agent-ready-mcp --command npx --arg -y --arg agent-ready-mcp

# ~/.hermes/config.yaml

mcp_servers:
  mlava-agent-ready-mcp:
    command: "npx"
    args: ["-y", "agent-ready-mcp"]

// mcp.json

{
  "mcpServers": {
    "mlava-agent-ready-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agent-ready-mcp"
      ]
    }
  }
}

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.

4 Aug 26 0
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
2 Aug 26 +41
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: mlava/agent-ready-mcp security
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
1 Aug 26 −3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 0
- Package version: 0.7.0 → 0.7.2 functional
30 Jul 26 −34
- Install scripts: pass → unverified ▼ security
- Known CVEs: partial → unverified ▼ security
- Provenance: pass → unverified ▼ security
- The attested source repository moved: mlava/agent-ready-mcp security
- License: pass → unverified ▼ functional
- Dependency health: partial → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Licence: MIT functional
28 Jul 26 +70
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- The attested source repository moved: mlava/agent-ready-mcp security
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- First check of Schema quality: good functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: fail functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- Licence: MIT functional
27 Jul 26 6

First indexed and scored.

Show 3 earlier entries Hide earlier entries

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 4 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: mlava/agent-ready-mcp
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/mlava/agent-ready-mcp/.github/workflows/release.yml@refs/tags/v0.7.2
Rekor log index:: 2296817486
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:af73f550717d12eaa1a8f5932794b97e30047f81c34a809f6925d5b3689436aeaf75f58890994a325a68d2ec30c433032b9e41d8037d6d1533ae88609
Discovery method:: attestation_endpoint

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-8j4g-w8fx-2239	CVE-2026-69207	medium	CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L	yes

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 4 exposed · ~619 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.

Tool Tokens

ask Ask Agent Ready in natural language ~181

Natural-language search (NLWeb /ask) over Agent Ready's own content — scoring methodology, the check registry, the specs it validates, and the content library (explainers, comparisons, how-to guides, glossary). Public, no API key required. Returns Schema.org-typed result objects; optional itemType narrows to a corpus type and mode 'summarize' adds an extractive summary.

Input Output Examples

Name	Type	Req	Description
itemType	string	—	Optional filter narrowing the search to one corpus type ('page' = explainers/guides/glossary).
mode	string	—	'summarize' adds an extractive summary over the top results.
q	string	yes	Natural-language question about Agent Ready's scoring methodology, its check registry, the specs it validates, or its content library (explainers, comparisons, how-to guides, glossary).

Name	Type	Req	Description
_meta	object	—	—
error	object	—	—
mode	string	—	—
query	string	—	—
query_id	string	—	—
results	array	—	—
site	string	—	—
summary	string	—	—

No examples provided.

get_scan Get a previous scan by id ~73

Fetches a completed or in-progress scan by its id. Requires a Pro API key — scan history is account-scoped. (Anonymous scan_site calls return their result inline, so keyless use never needs this tool.)

Input Output Examples

Name	Type	Req	Description
id	string	yes	Scan id returned by a previous scan_site call (10-character nanoid).

Name	Type	Req	Description
completedAt	—	—	—
createdAt	string	—	—
id	string	yes	—
llmstxtChecks	array	—	—
llmstxtScore	number	—	—
message	string	—	—
pageResults	array	—	—
pagesDiscovered	number	—	—
pagesScanned	number	—	—
pollUrl	string	—	—
rootUrl	string	—	—
saveUrl	string	—	—
shareToken	string	—	—
siteChecks	array	—	—
status	string	yes	—
url	string	—	—
vercelRating	string	—	—
vercelScore	number	—	—

No examples provided.

scan_site Scan a site for AI agent readability ~174

Runs the agent-ready.dev scanner against a URL and returns structured results: Vercel score, llmstxt.org score, and per-check findings with remediation hints. Works without an API key on the anonymous free tier (3 scans/30 days per IP, 25-page depth, synchronous). With a Pro AGENT_READY_API_KEY it scans deeper (up to 250 pages) and may take up to ~60s; if the local poll deadline elapses, the tool returns the scan id and asks you to poll with get_scan.

Input Output Examples

Name	Type	Req	Description
pageLimit	integer	—	Optional maximum number of pages to crawl from the root URL. Capped by your plan (Free 25, Pro 250, Team 2000).
url	string	yes	Fully-qualified URL to scan, including scheme (https://...).

Name	Type	Req	Description
completedAt	—	—	—
createdAt	string	—	—
id	string	yes	—
llmstxtChecks	array	—	—
llmstxtScore	number	—	—
message	string	—	—
pageResults	array	—	—
pagesDiscovered	number	—	—
pagesScanned	number	—	—
pollUrl	string	—	—
rootUrl	string	—	—
saveUrl	string	—	—
shareToken	string	—	—
siteChecks	array	—	—
status	string	yes	—
url	string	—	—
vercelRating	string	—	—
vercelScore	number	—	—

No examples provided.

validate_structured_data Validate JSON-LD structured data ~191

Validates a page's (or a pasted) JSON-LD against Agent Ready's structured-data checks (schema lint + agent-coherence: freshness honesty, canonical/.md coherence, entity-name consistency, extraction signal) and returns a verdict with per-check fix guidance. Provide exactly one of `url` (fetch + validate) or `jsonld` (validate a string the agent just authored — no network needed). Public, no API key required. The one structured-data check the first-party validators (validator.schema.org, Rich Results Test) don't do.

Input Output Examples

Name	Type	Req	Description
jsonld	string	—	A raw JSON-LD string to validate directly (paste mode) — e.g. structured data an agent just authored. Provide either jsonld OR url, not both.
url	string	—	URL of a page to fetch and validate its JSON-LD. Provide either url OR jsonld, not both.

Name	Type	Req	Description
checks	array	yes	—
mode	string	yes	—
summary	object	yes	—
url	—	yes	—

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 4 Aug