agent-ready-mcp 0.3.0 → 0.4.0

package/dist/mcp-server.mjs

@@ -9229,13 +9229,13 @@ var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
         canary.aborted = true;
         return canary;
       }
-      const checkResult = runChecks(payload, checks, ctx);
-      if (checkResult instanceof Promise) {
+      const checkResult2 = runChecks(payload, checks, ctx);
+      if (checkResult2 instanceof Promise) {
         if (ctx.async === false)
           throw new $ZodAsyncError();
-        return checkResult.then((checkResult2) => inst._zod.parse(checkResult2, ctx));
+        return checkResult2.then((checkResult3) => inst._zod.parse(checkResult3, ctx));
       }
-      return inst._zod.parse(checkResult, ctx);
+      return inst._zod.parse(checkResult2, ctx);
     };
     inst._zod.run = (payload, ctx) => {
       if (ctx.skipChecks) {
@@ -31529,22 +31529,22 @@ async function scanSite(config2, input) {
       throw err;
     }
     if (last && last.status && last.status !== "running") {
-      return { content: [{ type: "text", text: JSON.stringify(last) }] };
+      return {
+        content: [{ type: "text", text: JSON.stringify(last) }],
+        structuredContent: last
+      };
     }
   }
+  const running = {
+    id: placeholder.id,
+    status: "running",
+    url: input.url,
+    pollUrl: placeholder.pollUrl ?? `/api/v1/scans/${placeholder.id}`,
+    message: "Scan still running after the local poll deadline. Call get_scan with this id to fetch the final result."
+  };
   return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify({
-          id: placeholder.id,
-          status: "running",
-          url: input.url,
-          pollUrl: placeholder.pollUrl ?? `/api/v1/scans/${placeholder.id}`,
-          message: "Scan still running after the local poll deadline. Call get_scan with this id to fetch the final result."
-        })
-      }
-    ]
+    content: [{ type: "text", text: JSON.stringify(running) }],
+    structuredContent: running
   };
 }
 
@@ -31552,7 +31552,10 @@ async function scanSite(config2, input) {
 async function getScanById(config2, input) {
   try {
     const scan = await getScanFromApi(config2, input.id);
-    return { content: [{ type: "text", text: JSON.stringify(scan) }] };
+    return {
+      content: [{ type: "text", text: JSON.stringify(scan) }],
+      structuredContent: scan
+    };
   } catch (err) {
     if (err instanceof ApiError) {
       if (err.status === 404) {
@@ -31568,7 +31571,10 @@ async function getScanById(config2, input) {
 async function askQuery(config2, input) {
   try {
     const envelope = await postAsk(config2, input);
-    return { content: [{ type: "text", text: JSON.stringify(envelope) }] };
+    return {
+      content: [{ type: "text", text: JSON.stringify(envelope) }],
+      structuredContent: envelope && typeof envelope === "object" ? envelope : {}
+    };
   } catch (err) {
     if (err instanceof ApiError) {
       throw new ToolError(err.code, err.message);
@@ -31577,6 +31583,62 @@ async function askQuery(config2, input) {
   }
 }
 
+// src/output.ts
+var checkResult = external_exports.object({
+  checkId: external_exports.string(),
+  name: external_exports.string(),
+  status: external_exports.enum(["pass", "fail", "warn", "error"]),
+  message: external_exports.string(),
+  howToFix: external_exports.string().nullable(),
+  details: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+});
+var pageResult = external_exports.object({
+  url: external_exports.string(),
+  checks: external_exports.array(checkResult)
+});
+var scanOutputShape = {
+  id: external_exports.string(),
+  status: external_exports.enum(["running", "completed", "failed"]),
+  rootUrl: external_exports.string().optional(),
+  createdAt: external_exports.string().optional(),
+  completedAt: external_exports.string().nullable().optional(),
+  pagesDiscovered: external_exports.number().optional(),
+  pagesScanned: external_exports.number().optional(),
+  vercelScore: external_exports.number().optional(),
+  vercelRating: external_exports.string().optional(),
+  llmstxtScore: external_exports.number().optional(),
+  siteChecks: external_exports.array(checkResult).optional(),
+  llmstxtChecks: external_exports.array(checkResult).optional(),
+  pageResults: external_exports.array(pageResult).optional(),
+  shareToken: external_exports.string().optional(),
+  // Present only on the running placeholder, not on a full Scan.
+  url: external_exports.string().optional(),
+  pollUrl: external_exports.string().optional(),
+  message: external_exports.string().optional()
+};
+var askResult = external_exports.object({
+  url: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  site: external_exports.string().optional(),
+  score: external_exports.number().optional(),
+  description: external_exports.string().optional(),
+  schema_object: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+});
+var askOutputShape = {
+  _meta: external_exports.object({
+    response_type: external_exports.string(),
+    version: external_exports.string().optional(),
+    mode: external_exports.string().optional()
+  }).optional(),
+  query_id: external_exports.string().optional(),
+  site: external_exports.string().optional(),
+  mode: external_exports.string().optional(),
+  query: external_exports.string().optional(),
+  results: external_exports.array(askResult).optional(),
+  summary: external_exports.string().optional(),
+  error: external_exports.object({ code: external_exports.string(), message: external_exports.string() }).optional()
+};
+
 // src/types.ts
 var scanSiteInputShape = {
   url: external_exports.string().url().max(2e3).describe("Fully-qualified URL to scan, including scheme (https://...)."),
@@ -31600,7 +31662,7 @@ var askInputShape = {
 // src/server.ts
 var SERVER_INFO = {
   name: "agent-ready",
-  version: "0.3.0"
+  version: "0.4.0"
 };
 function createMcpServer(config2) {
   const server = new McpServer(SERVER_INFO);
@@ -31616,6 +31678,7 @@ function createMcpServer(config2) {
       title: "Scan a site for AI agent readability",
       description: "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. Scans 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.",
       inputSchema: scanSiteInputShape,
+      outputSchema: scanOutputShape,
       annotations: READ_ONLY_OPEN_WORLD
     },
     async (args) => {
@@ -31632,6 +31695,7 @@ function createMcpServer(config2) {
       title: "Get a previous scan by id",
       description: "Fetches a completed or in-progress scan by its id. Only scans owned by the authenticated API key's user are returned.",
       inputSchema: getScanInputShape,
+      outputSchema: scanOutputShape,
       annotations: READ_ONLY_OPEN_WORLD
     },
     async (args) => {
@@ -31648,6 +31712,7 @@ function createMcpServer(config2) {
       title: "Ask Agent Ready in natural language",
       description: "Natural-language search (NLWeb /ask) over Agent Ready's own content \u2014 scoring methodology, the check registry, and the specs it validates. 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.",
       inputSchema: askInputShape,
+      outputSchema: askOutputShape,
       annotations: READ_ONLY_OPEN_WORLD
     },
     async (args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-ready-mcp",
-  "version": "0.3.0",
+  "version": "0.4.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). 60 checks with per-check fix guidance.",
   "license": "MIT",