agent-ready-mcp 0.4.3 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # agent-ready-mcp
 
-MCP server for [Agent Ready](https://agent-ready.dev) — scan any URL for AI agent readability against the [Vercel Agent Readability Spec](https://vercel.com/kb/guide/agent-readability-spec), the [llmstxt.org](https://llmstxt.org) standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). 68 checks across four spec families — 38 against the Vercel spec (15 site-wide + 23 per-page), 10 against llmstxt.org, and 20 against agent-protocol manifests — each with per-check fix guidance.
+MCP server for [Agent Ready](https://agent-ready.dev) — scan any URL for AI agent readability against the [Vercel Agent Readability Spec](https://vercel.com/kb/guide/agent-readability-spec), the [llmstxt.org](https://llmstxt.org) standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). 69 checks across four spec families — 38 against the Vercel spec (15 site-wide + 23 per-page), 10 against llmstxt.org, and 21 against agent-protocol manifests — each with per-check fix guidance.
 
 Hosted at `https://agent-ready.dev/api/v1/mcp` (Streamable HTTP); this package is a thin stdio wrapper around the same REST endpoints, distributed via npm for local MCP clients (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf).
 
@@ -9,6 +9,7 @@ Hosted at `https://agent-ready.dev/api/v1/mcp` (Streamable HTTP); this package i
 - **`scan_site`** — fresh agent-readability scan on any URL. Polls the hosted API up to 60s; returns the full scan or a `running` placeholder.
 - **`get_scan`** — fetch a previously-run scan by id.
 - **`ask`** — natural-language (NLWeb) search over Agent Ready's own methodology, checks, and specs. Public, no API key required; returns Schema.org-typed results.
+- **`validate_structured_data`** — validate a page's (or a pasted) JSON-LD against Agent Ready's structured-data checks. Public, no API key required; paste mode needs no network, so an agent can check JSON-LD it just authored.
 - **Three discovery prompts** — `scan`, `interpret_scan`, `remediation_plan`. End-to-end workflows from URL → score → fix-it plan.
 - **`SKILL.md`** — Claude Skill descriptor included under `skills/agent-ready/` for activation routing.
 
@@ -76,6 +77,7 @@ claude mcp add agent-ready \
 | `scan_site` | `url` (string, required), `pageLimit` (number, optional, max 2000 — capped by your plan) | Scan object: Vercel score 0–100, llms.txt sub-score 0–100, per-check findings with `howToFix` strings. Returns `{ id, status: "running" }` placeholder if the scan exceeds the poll deadline. |
 | `get_scan` | `id` (string, scan id from a prior `scan_site` call) | Same scan object as `scan_site`, or `not_found` if the id is unknown or doesn't belong to the authenticated user. |
 | `ask` | `q` (string, required), `itemType` (optional corpus filter), `mode` (optional, `list` or `summarize`) | NLWeb `/ask` over Agent Ready's methodology, checks, and specs. Public — no API key required. Schema.org-typed result objects. |
+| `validate_structured_data` | exactly one of `url` (string) or `jsonld` (string) | D-series structured-data result: `mode`, `url`, per-check findings, and a `summary` verdict. Public — no API key required. Validates schema lint + agent-coherence the first-party validators don't. |
 
 ## Prompts
 
@@ -115,7 +117,7 @@ If you'd rather use the hosted MCP server directly (Streamable HTTP transport, n
 
 ## Methodology
 
-The 68 checks, their weights, and the score formula are documented at [agent-ready.dev/methodology](https://agent-ready.dev/methodology). Both `manifest.json` and `server.json` in this repo conform to the relevant registry schemas (Glama Marketplace v0.3 and MCP registry 2025-12-11 respectively).
+The 69 checks, their weights, and the score formula are documented at [agent-ready.dev/methodology](https://agent-ready.dev/methodology). Both `manifest.json` and `server.json` in this repo conform to the relevant registry schemas (Glama Marketplace v0.3 and MCP registry 2025-12-11 respectively).
 
 ## Development
 

package/dist/mcp-server.mjs

@@ -23153,6 +23153,47 @@ async function postAsk(config2, body) {
   }
   return payload;
 }
+async function postValidateStructuredData(config2, body) {
+  const path = "/api/v1/validate/structured-data";
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json"
+  };
+  if (config2.apiKey) headers.Authorization = `Bearer ${config2.apiKey}`;
+  let res;
+  try {
+    res = await fetch(`${config2.baseUrl}${path}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(config2.getTimeoutMs)
+    });
+  } catch (err) {
+    if (err instanceof Error && err.name === "TimeoutError") {
+      throw new ApiError(
+        "timeout",
+        `Request to ${path} timed out after ${config2.getTimeoutMs}ms.`
+      );
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    throw new ApiError("network_error", `Network error calling ${path}: ${message}`);
+  }
+  const text = await res.text();
+  let payload = null;
+  if (text.length > 0) {
+    try {
+      payload = JSON.parse(text);
+    } catch {
+    }
+  }
+  if (!res.ok) {
+    const detail = payload && typeof payload === "object" && "error" in payload ? payload.error : null;
+    const code = detail?.code ?? `http_${res.status}`;
+    const message = (detail?.message ?? text) || `HTTP ${res.status} from ${path}`;
+    throw new ApiError(code, message, res.status);
+  }
+  return payload;
+}
 
 // node_modules/zod/v3/helpers/util.js
 var util;
@@ -31181,7 +31222,7 @@ Skip checks that already pass.`
 // src/resource-content.ts
 var METHODOLOGY_MD = `# How Agent Ready scores a site
 
-> 68 checks across four categories, mapped to the Vercel Agent Readability Spec and the llmstxt.org standard. Every check is open and reproducible.
+> 69 checks across four categories, mapped to the Vercel Agent Readability Spec and the llmstxt.org standard. Every check is open and reproducible.
 
 ## What does Agent Ready measure?
 
@@ -31218,7 +31259,7 @@ Full guide: <https://agent-ready.dev/methodology>
 `;
 var CHECKS_MD = `# Agent Ready check registry
 
-> 68 checks total across four categories. IDs are stable and referenced in every scan result's \`details\` array. Each check is implemented as a single function in \`src/lib/checks/{category}/{id}-{slug}.ts\` in the agent-ready repository.
+> 69 checks total across four categories. IDs are stable and referenced in every scan result's \`details\` array. Each check is implemented as a single function in \`src/lib/checks/{category}/{id}-{slug}.ts\` in the agent-ready repository.
 
 ## Site checks (15)
 
@@ -31289,7 +31330,7 @@ Run when the site has an \`llms.txt\` file. Validate against the [llmstxt.org](h
 | L9 | Content-Type: text/plain |
 | L10 | llms-full.txt available |
 
-## Protocol checks (20)
+## Protocol checks (21)
 
 Discover-then-validate: when the relevant well-known endpoint returns 404, the check drops rather than failing. A marketing site doesn't score itself against agent manifests it has no reason to ship.
 
@@ -31315,10 +31356,11 @@ Discover-then-validate: when the relevant well-known endpoint returns 404, the c
 | C18 | MPP Payment challenge |
 | C19 | MPP challenge params |
 | C20 | AP2 payment protocol support |
+| C21 | ACP profile (/.well-known/acp.json) |
 `;
 var LLMS_TXT = `# Agent Ready
 
-> Agent Ready is a free tool that scores any website against the Vercel Agent Readability Spec, the llmstxt.org specification, and agent-protocol specs (MCP, A2A, agents.json). It runs 68 checks and provides actionable fix guidance for every failing check.
+> Agent Ready is a free tool that scores any website against the Vercel Agent Readability Spec, the llmstxt.org specification, and agent-protocol specs (MCP, A2A, agents.json). It runs 69 checks and provides actionable fix guidance for every failing check.
 
 This resource mirrors agent-ready.dev's own /llms.txt so MCP clients can introspect the same surface that ChatGPT, Perplexity, and other AI agents see when discovering Agent Ready as a tool.
 
@@ -31363,6 +31405,7 @@ Agent Ready's checks map to the specifications below. Each entry links to the ca
 - **agent-permissions.json** _(pre-standard)_ \u2014 A manifest declaring per-path agent access policies, served at /.well-known/agent-permissions.json. No canonical spec document yet \u2014 defined by the discovery path. Canonical: _none published_ Checks: C7.
 - **UCP \u2014 Unified Capability Profile** \u2014 A composite profile at /.well-known/ucp bundling OAuth authorization-server metadata with capability declarations. Canonical: <https://ucp.dev> Checks: C8.
 - **OAuth Authorization Server Metadata (RFC 8414)** \u2014 The authorization-server metadata a UCP profile references so agents can complete an OAuth flow. Gated on C8. Canonical: <https://datatracker.ietf.org/doc/html/rfc8414> Checks: C9.
+- **ACP \u2014 Agentic Commerce Protocol** _(pre-standard)_ \u2014 OpenAI and Stripe's agentic-commerce standard. Sellers advertise support via a discovery document at /.well-known/acp.json declaring protocol version, transports, and capabilities (C21). Pre-standard \u2014 the discovery RFC is a Proposal. Canonical: <https://github.com/agentic-commerce-protocol/agentic-commerce-protocol/blob/main/rfcs/rfc.discovery.md> Checks: C21.
 
 ## Payments
 
@@ -31387,7 +31430,7 @@ function registerResources(server) {
     "agent-ready://methodology",
     {
       title: "Scoring methodology",
-      description: "How Agent Ready computes the 0\u2013100 readability score and the llms.txt sub-score. Covers the 68 checks across four categories, rating bands, weighting, and JS-rendering handling.",
+      description: "How Agent Ready computes the 0\u2013100 readability score and the llms.txt sub-score. Covers the 69 checks across four categories, rating bands, weighting, and JS-rendering handling.",
       mimeType: "text/markdown"
     },
     async () => ({
@@ -31405,7 +31448,7 @@ function registerResources(server) {
     "agent-ready://checks",
     {
       title: "Check registry",
-      description: "Reference table of all 68 checks Agent Ready runs, grouped by category (site, page, llms.txt, protocol). Each row pairs the stable check ID (e.g. P11, S15, L9, C3) with its human-readable name. Use this to identify a check by id when interpreting scan results.",
+      description: "Reference table of all 69 checks Agent Ready runs, grouped by category (site, page, llms.txt, protocol). Each row pairs the stable check ID (e.g. P11, S15, L9, C3) with its human-readable name. Use this to identify a check by id when interpreting scan results.",
       mimeType: "text/markdown"
     },
     async () => ({
@@ -31564,6 +31607,33 @@ async function askQuery(config2, input) {
   }
 }
 
+// src/tools/validateStructuredData.ts
+async function validateStructuredData(config2, input) {
+  const url2 = input.url?.trim();
+  const jsonld = input.jsonld?.trim();
+  if (Boolean(url2) === Boolean(jsonld)) {
+    throw new ToolError(
+      "invalid_request",
+      "Provide exactly one of `url` (fetch + validate) or `jsonld` (validate a pasted string)."
+    );
+  }
+  try {
+    const result = await postValidateStructuredData(
+      config2,
+      url2 ? { url: url2 } : { jsonld }
+    );
+    return {
+      content: [{ type: "text", text: JSON.stringify(result) }],
+      structuredContent: result && typeof result === "object" ? result : {}
+    };
+  } catch (err) {
+    if (err instanceof ApiError) {
+      throw new ToolError(err.code, err.message);
+    }
+    throw err;
+  }
+}
+
 // src/output.ts
 var checkResult = external_exports.object({
   checkId: external_exports.string(),
@@ -31597,6 +31667,17 @@ var scanOutputShape = {
   pollUrl: external_exports.string().optional(),
   message: external_exports.string().optional()
 };
+var validateOutputShape = {
+  mode: external_exports.enum(["url", "paste"]),
+  url: external_exports.string().nullable(),
+  checks: external_exports.array(checkResult),
+  summary: external_exports.object({
+    pass: external_exports.number(),
+    warn: external_exports.number(),
+    fail: external_exports.number(),
+    verdict: external_exports.enum(["agent-ready", "needs-work", "not-agent-readable"])
+  })
+};
 var askResult = external_exports.object({
   url: external_exports.string().optional(),
   name: external_exports.string().optional(),
@@ -31641,11 +31722,19 @@ var askInputShape = {
   ),
   mode: external_exports.enum(["list", "summarize"]).optional().describe("'summarize' adds an extractive summary over the top results.")
 };
+var validateStructuredDataInputShape = {
+  url: external_exports.string().url().max(2e3).optional().describe(
+    "URL of a page to fetch and validate its JSON-LD. Provide either url OR jsonld, not both."
+  ),
+  jsonld: external_exports.string().max(1e5).optional().describe(
+    "A raw JSON-LD string to validate directly (paste mode) \u2014 e.g. structured data an agent just authored. Provide either jsonld OR url, not both."
+  )
+};
 
 // src/server.ts
 var SERVER_INFO = {
   name: "agent-ready",
-  version: "0.4.2"
+  version: "0.5.0"
 };
 function createMcpServer(config2) {
   const server = new McpServer(SERVER_INFO);
@@ -31706,6 +31795,23 @@ function createMcpServer(config2) {
       }
     }
   );
+  server.registerTool(
+    "validate_structured_data",
+    {
+      title: "Validate JSON-LD structured data",
+      description: "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 \u2014 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.",
+      inputSchema: validateStructuredDataInputShape,
+      outputSchema: validateOutputShape,
+      annotations: READ_ONLY_OPEN_WORLD
+    },
+    async (args) => {
+      try {
+        return await validateStructuredData(config2, args);
+      } catch (err) {
+        return toolErrorToContent(err);
+      }
+    }
+  );
   registerPrompts(server);
   registerResources(server);
   return server;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "agent-ready-mcp",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "mcpName": "io.github.mlava/agent-ready-mcp",
-  "description": "MCP server for Agent Ready — scan any URL for AI-readability against the Vercel Agent Readability Spec, the llmstxt.org standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). 68 checks with per-check fix guidance.",
+  "description": "MCP server for Agent Ready — scan any URL for AI-readability against the Vercel Agent Readability Spec, the llmstxt.org standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). 69 checks with per-check fix guidance.",
   "license": "MIT",
   "author": "Agent Ready",
   "repository": {