agent-ready-mcp 0.5.2 → 0.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/mcp-server.mjs +31 -11
- package/package.json +1 -1
package/dist/mcp-server.mjs
CHANGED
|
@@ -31357,10 +31357,26 @@ Discover-then-validate: when the relevant well-known endpoint returns 404, the c
|
|
|
31357
31357
|
| C19 | MPP challenge params |
|
|
31358
31358
|
| C20 | AP2 payment protocol support |
|
|
31359
31359
|
| C21 | ACP profile (/.well-known/acp.json) |
|
|
31360
|
+
|
|
31361
|
+
## Accessibility checks (9)
|
|
31362
|
+
|
|
31363
|
+
Run over the homepage DOM (v1). WCAG-grounded accessibility-tree signals \u2014 image text alternatives, form labels, control names \u2014 plus a static layout-stability (CLS) proxy. Scored into a separate \`accessibilityScore\`, a distinct suite from the 69 checks above: accessibility is WCAG, not the Vercel Agent Readability Spec, so it never moves the Vercel score.
|
|
31364
|
+
|
|
31365
|
+
| ID | Check |
|
|
31366
|
+
|---|---|
|
|
31367
|
+
| A1 | Images have text alternatives |
|
|
31368
|
+
| A2 | Form controls have labels |
|
|
31369
|
+
| A3 | Controls have accessible names |
|
|
31370
|
+
| A4 | Media declares explicit dimensions |
|
|
31371
|
+
| A5 | ARIA name references resolve |
|
|
31372
|
+
| A6 | Iframes have an accessible name |
|
|
31373
|
+
| A7 | Heading hierarchy is well-formed |
|
|
31374
|
+
| A8 | No positive tabindex |
|
|
31375
|
+
| A9 | Pinch-zoom is not disabled |
|
|
31360
31376
|
`;
|
|
31361
31377
|
var LLMS_TXT = `# Agent Ready
|
|
31362
31378
|
|
|
31363
|
-
> 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.
|
|
31379
|
+
> 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 \u2014 plus a separate accessibility sub-score from 9 WCAG 2.2 / layout-stability checks \u2014 and provides actionable fix guidance for every failing check.
|
|
31364
31380
|
|
|
31365
31381
|
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.
|
|
31366
31382
|
|
|
@@ -31398,29 +31414,33 @@ Agent Ready's checks map to the specifications below. Each entry links to the ca
|
|
|
31398
31414
|
|
|
31399
31415
|
## Agent protocols
|
|
31400
31416
|
|
|
31401
|
-
- **MCP Server Cards (SEP-1649)** \u2014 The Model Context Protocol discovery card at /.well-known/mcp.json \u2014 its presence (C1) and required fields (C2). Canonical: <https://modelcontextprotocol
|
|
31417
|
+
- **MCP Server Cards (SEP-1649)** \u2014 The Model Context Protocol discovery card at /.well-known/mcp.json \u2014 its presence (C1) and required fields (C2). Canonical: <https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1649> Checks: C1, C2.
|
|
31402
31418
|
- **OAuth Protected Resource Metadata (RFC 9728)** \u2014 Protected-resource metadata an MCP server advertises so agents can locate its authorization server. Canonical: <https://datatracker.ietf.org/doc/html/rfc9728> Checks: C3.
|
|
31403
|
-
- **A2A Protocol \u2014 Agent Cards** \u2014 The agent card at /.well-known/agent-card.json that lets agents discover and call other agents \u2014 existence with correct Content-Type (C4) and required fields (C5). Canonical: <https://a2a-protocol.org> Checks: C4, C5.
|
|
31419
|
+
- **A2A Protocol \u2014 Agent Cards** \u2014 The agent card at /.well-known/agent-card.json that lets agents discover and call other agents \u2014 existence with correct Content-Type (C4) and required fields (C5). Canonical: <https://a2a-protocol.org/v1.0.0/specification> Checks: C4, C5.
|
|
31404
31420
|
- **Wildcard agents.json** _(pre-standard)_ \u2014 An OpenAPI extension declaring which existing REST endpoints agents should call. Pre-standard (v0.1.0). Canonical: <https://github.com/wild-card-ai/agents-json> Checks: C6.
|
|
31405
|
-
- **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:
|
|
31406
|
-
- **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
|
|
31421
|
+
- **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: <https://github.com/las-wg/agent-permissions.json/blob/main/README.md> Checks: C7.
|
|
31422
|
+
- **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/2026-04-08/specification/overview/> Checks: C8.
|
|
31407
31423
|
- **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.
|
|
31408
31424
|
- **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.
|
|
31409
31425
|
|
|
31410
31426
|
## Payments
|
|
31411
31427
|
|
|
31412
|
-
- **x402 \u2014 HTTP 402 Payment Required** \u2014 A behavioural payments scheme: a paid endpoint answers with HTTP 402 and a JSON body carrying an accepts array \u2014 the 402 response (C10) and valid accepts entries (C11). Canonical: <https://
|
|
31413
|
-
- **MPP \u2014 Machine Payments Protocol** _(pre-standard)_ \u2014 The Stripe- and Tempo-authored "Payment" HTTP auth scheme on the IETF standards track \u2014 the WWW-Authenticate: Payment challenge (C18) and its required params (C19). Canonical: <https://paymentauth.org
|
|
31428
|
+
- **x402 \u2014 HTTP 402 Payment Required** \u2014 A behavioural payments scheme: a paid endpoint answers with HTTP 402 and a JSON body carrying an accepts array \u2014 the 402 response (C10) and valid accepts entries (C11). Canonical: <https://github.com/coinbase/x402/blob/main/specs/x402-specification-v2.md> Checks: C10, C11.
|
|
31429
|
+
- **MPP \u2014 Machine Payments Protocol** _(pre-standard)_ \u2014 The Stripe- and Tempo-authored "Payment" HTTP auth scheme on the IETF standards track \u2014 the WWW-Authenticate: Payment challenge (C18) and its required params (C19). Canonical: <https://paymentauth.org/draft-httpauth-payment-00.html> Checks: C18, C19.
|
|
31414
31430
|
- **AP2 \u2014 Agent Payments Protocol** _(pre-standard)_ \u2014 Google's trust/authorization layer for agent-led payments, built on A2A: a participant advertises support via the AP2 extension URI in its A2A Agent Card. Detection only \u2014 mandate verifiable credentials are runtime SD-JWTs with no static artifact. Pre-standard (v0.2.0). Canonical: <https://github.com/google-agentic-commerce/AP2> Checks: C20.
|
|
31415
31431
|
|
|
31416
31432
|
## Discovery & integrity
|
|
31417
31433
|
|
|
31418
31434
|
- **NLWeb** \u2014 An open natural-language query protocol: a site exposes POST /ask returning Schema.org-typed JSON. Detection is heuristic and informational. Canonical: <https://nlweb.ai/docs/specification> Checks: C12.
|
|
31419
31435
|
- **API Catalog (RFC 9727)** \u2014 A /.well-known/api-catalog linkset advertising a site's APIs so agents can enumerate them from one well-known entry point. Canonical: <https://www.rfc-editor.org/info/rfc9727> Checks: C13.
|
|
31420
|
-
- **Web Bot Auth** _(pre-standard)_ \u2014 An HTTP message-signatures directory at /.well-known/http-message-signatures-directory letting well-behaved bots prove their identity. IETF draft. Canonical: <https://datatracker.ietf.org/doc/draft-meunier-web-bot-auth-architecture
|
|
31421
|
-
- **Agent Skills Discovery** _(pre-standard)_ \u2014 A /.well-known/agent-skills/index.json manifest advertising installable agent skills. Pre-standard (Cloudflare RFC v0.2.0). Canonical: <https://github.com/cloudflare/agent-skills-discovery-rfc> Checks: C15.
|
|
31436
|
+
- **Web Bot Auth** _(pre-standard)_ \u2014 An HTTP message-signatures directory at /.well-known/http-message-signatures-directory letting well-behaved bots prove their identity. IETF draft. Canonical: <https://datatracker.ietf.org/doc/html/draft-meunier-web-bot-auth-architecture-05> Checks: C14.
|
|
31437
|
+
- **Agent Skills Discovery** _(pre-standard)_ \u2014 A /.well-known/agent-skills/index.json manifest advertising installable agent skills. Pre-standard (Cloudflare RFC v0.2.0). Canonical: <https://github.com/cloudflare/agent-skills-discovery-rfc/blob/main/README.md> Checks: C15.
|
|
31422
31438
|
- **Content parity (anti-cloaking)** _(behavioural)_ \u2014 Not a published spec \u2014 a behavioural check comparing the AI-bot response to the baseline to detect cloaking (serving agents different content than humans). Canonical: _none published_ Checks: C16.
|
|
31423
31439
|
- **Agent-driven UI (A2UI)** _(pre-standard)_ \u2014 MCP-Apps / OpenAI Apps SDK UI surfaces declared on an MCP Server Card, letting agents render interactive widgets inline. Emerging. Canonical: <https://modelcontextprotocol.io> Checks: C17.
|
|
31440
|
+
|
|
31441
|
+
## Accessibility
|
|
31442
|
+
|
|
31443
|
+
- **WCAG 2.2 + layout stability** \u2014 The accessibility tree \u2014 image text alternatives, form labels, control names, resolved ARIA references, named iframes, a clean heading outline \u2014 is what assistive tech and AI agents parse to act on a page; explicit media dimensions and enabled zoom keep it stable and usable (with a static CLS proxy). Scored as a separate accessibilityScore, not part of the Vercel score. Canonical: <https://www.w3.org/TR/WCAG22/> Checks: A1\u2013A9.
|
|
31424
31444
|
`;
|
|
31425
31445
|
|
|
31426
31446
|
// src/resources.ts
|
|
@@ -31448,7 +31468,7 @@ function registerResources(server) {
|
|
|
31448
31468
|
"agent-ready://checks",
|
|
31449
31469
|
{
|
|
31450
31470
|
title: "Check registry",
|
|
31451
|
-
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.",
|
|
31471
|
+
description: "Reference table of all 69 checks Agent Ready runs, grouped by category (site, page, llms.txt, protocol), plus the 9-check accessibility suite scored as a separate accessibility sub-score. Each row pairs the stable check ID (e.g. P11, S15, L9, C3, A7) with its human-readable name. Use this to identify a check by id when interpreting scan results.",
|
|
31452
31472
|
mimeType: "text/markdown"
|
|
31453
31473
|
},
|
|
31454
31474
|
async () => ({
|
|
@@ -31734,7 +31754,7 @@ var validateStructuredDataInputShape = {
|
|
|
31734
31754
|
// src/server.ts
|
|
31735
31755
|
var SERVER_INFO = {
|
|
31736
31756
|
name: "agent-ready",
|
|
31737
|
-
version: "0.5.
|
|
31757
|
+
version: "0.5.4"
|
|
31738
31758
|
};
|
|
31739
31759
|
function createMcpServer(config2) {
|
|
31740
31760
|
const server = new McpServer(SERVER_INFO);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-ready-mcp",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.4",
|
|
4
4
|
"mcpName": "io.github.mlava/agent-ready-mcp",
|
|
5
5
|
"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.",
|
|
6
6
|
"license": "MIT",
|