@agents-txt/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agents-txt contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-RNL5YPEA.js

@@ -0,0 +1,81 @@
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgentsTxtClient } from "@agents-txt/core";
+async function createAgentsTxtServer(targetUrl) {
+  const client = new AgentsTxtClient();
+  let result = await client.discoverJSON(targetUrl);
+  if (!result.success) {
+    result = await client.discover(targetUrl);
+  }
+  if (!result.success || !result.document) {
+    throw new Error(
+      `Failed to discover agents.txt at ${targetUrl}: ${result.errors.map((e) => e.message).join(", ")}`
+    );
+  }
+  const doc = result.document;
+  const server = new McpServer({
+    name: `agents-txt: ${doc.site.name}`,
+    version: "0.1.0"
+  });
+  for (const cap of doc.capabilities) {
+    if (cap.protocol === "REST") {
+      registerRestTool(server, cap);
+    }
+  }
+  return { server, document: doc };
+}
+function registerRestTool(server, cap) {
+  const properties = {};
+  const required = [];
+  if (cap.parameters) {
+    for (const param of cap.parameters) {
+      properties[param.name] = {
+        type: param.type === "integer" ? "number" : param.type,
+        description: param.description
+      };
+      if (param.required) required.push(param.name);
+    }
+  }
+  server.tool(
+    cap.id,
+    cap.description,
+    properties,
+    async (args) => {
+      const url = new URL(cap.endpoint);
+      for (const [key, value] of Object.entries(args)) {
+        if (value !== void 0 && value !== null) {
+          url.searchParams.set(key, String(value));
+        }
+      }
+      try {
+        const response = await fetch(url.toString(), {
+          method: cap.method ?? "GET",
+          headers: {
+            "Accept": "application/json",
+            "User-Agent": "agents-txt-mcp/0.1"
+          }
+        });
+        if (!response.ok) {
+          return {
+            content: [{ type: "text", text: `Error: HTTP ${response.status} ${response.statusText}` }]
+          };
+        }
+        const data = await response.text();
+        return {
+          content: [{ type: "text", text: data }]
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error calling ${cap.endpoint}: ${err instanceof Error ? err.message : "Unknown error"}`
+          }]
+        };
+      }
+    }
+  );
+}
+
+export {
+  createAgentsTxtServer
+};

package/dist/chunk-TLN4YSVV.js

@@ -0,0 +1,130 @@
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AgentsTxtClient } from "@agents-txt/core";
+async function createAgentsTxtServer(targetUrl, options = {}) {
+  const client = new AgentsTxtClient();
+  let result = await client.discoverJSON(targetUrl);
+  if (!result.success) {
+    result = await client.discover(targetUrl);
+  }
+  if (!result.success || !result.document) {
+    throw new Error(
+      `Failed to discover agents.txt at ${targetUrl}: ${result.errors.map((e) => e.message).join(", ")}`
+    );
+  }
+  const doc = result.document;
+  const server = new McpServer({
+    name: `agents-txt: ${doc.site.name}`,
+    version: "0.1.0"
+  });
+  for (const cap of doc.capabilities) {
+    if (cap.protocol === "REST") {
+      registerRestTool(server, cap, options);
+    }
+  }
+  return { server, document: doc };
+}
+function buildAuthHeaders(cap, options) {
+  const headers = {};
+  if (!cap.auth || cap.auth.type === "none") return headers;
+  switch (cap.auth.type) {
+    case "bearer-token":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+    case "api-key":
+      if (options.apiKey) {
+        headers["X-API-Key"] = options.apiKey;
+      }
+      break;
+    case "oauth2":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+  }
+  return headers;
+}
+function registerRestTool(server, cap, options) {
+  const properties = {};
+  const required = [];
+  if (cap.parameters) {
+    for (const param of cap.parameters) {
+      properties[param.name] = {
+        type: param.type === "integer" ? "number" : param.type,
+        description: param.description
+      };
+      if (param.required) required.push(param.name);
+    }
+  }
+  server.tool(
+    cap.id,
+    cap.description,
+    properties,
+    async (args) => {
+      const method = (cap.method ?? "GET").toUpperCase();
+      const url = new URL(cap.endpoint);
+      const authHeaders = buildAuthHeaders(cap, options);
+      const headers = {
+        "Accept": "application/json",
+        "User-Agent": "agents-txt-mcp/0.1",
+        ...authHeaders
+      };
+      let body;
+      if (method === "GET" || method === "HEAD") {
+        for (const [key, value] of Object.entries(args)) {
+          if (value !== void 0 && value !== null) {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      } else {
+        const bodyArgs = {};
+        for (const [key, value] of Object.entries(args)) {
+          if (value === void 0 || value === null) continue;
+          const paramDef = cap.parameters?.find((p) => p.name === key);
+          if (paramDef?.in === "query") {
+            url.searchParams.set(key, String(value));
+          } else {
+            bodyArgs[key] = value;
+          }
+        }
+        if (Object.keys(bodyArgs).length > 0) {
+          headers["Content-Type"] = "application/json";
+          body = JSON.stringify(bodyArgs);
+        }
+      }
+      try {
+        const response = await fetch(url.toString(), {
+          method,
+          headers,
+          body
+        });
+        const data = await response.text();
+        if (!response.ok) {
+          return {
+            content: [{
+              type: "text",
+              text: `Error: HTTP ${response.status} ${response.statusText}
+${data}`
+            }]
+          };
+        }
+        return {
+          content: [{ type: "text", text: data }]
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error calling ${cap.endpoint}: ${err instanceof Error ? err.message : "Unknown error"}`
+          }]
+        };
+      }
+    }
+  );
+}
+
+export {
+  createAgentsTxtServer
+};

package/dist/cli.cjs

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/cli.ts
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+
+// src/server.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_core = require("@agents-txt/core");
+async function createAgentsTxtServer(targetUrl2, options = {}) {
+  const client = new import_core.AgentsTxtClient();
+  let result = await client.discoverJSON(targetUrl2);
+  if (!result.success) {
+    result = await client.discover(targetUrl2);
+  }
+  if (!result.success || !result.document) {
+    throw new Error(
+      `Failed to discover agents.txt at ${targetUrl2}: ${result.errors.map((e) => e.message).join(", ")}`
+    );
+  }
+  const doc = result.document;
+  const server = new import_mcp.McpServer({
+    name: `agents-txt: ${doc.site.name}`,
+    version: "0.1.0"
+  });
+  for (const cap of doc.capabilities) {
+    if (cap.protocol === "REST") {
+      registerRestTool(server, cap, options);
+    }
+  }
+  return { server, document: doc };
+}
+function buildAuthHeaders(cap, options) {
+  const headers = {};
+  if (!cap.auth || cap.auth.type === "none") return headers;
+  switch (cap.auth.type) {
+    case "bearer-token":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+    case "api-key":
+      if (options.apiKey) {
+        headers["X-API-Key"] = options.apiKey;
+      }
+      break;
+    case "oauth2":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+  }
+  return headers;
+}
+function registerRestTool(server, cap, options) {
+  const properties = {};
+  const required = [];
+  if (cap.parameters) {
+    for (const param of cap.parameters) {
+      properties[param.name] = {
+        type: param.type === "integer" ? "number" : param.type,
+        description: param.description
+      };
+      if (param.required) required.push(param.name);
+    }
+  }
+  server.tool(
+    cap.id,
+    cap.description,
+    properties,
+    async (args) => {
+      const method = (cap.method ?? "GET").toUpperCase();
+      const url = new URL(cap.endpoint);
+      const authHeaders = buildAuthHeaders(cap, options);
+      const headers = {
+        "Accept": "application/json",
+        "User-Agent": "agents-txt-mcp/0.1",
+        ...authHeaders
+      };
+      let body;
+      if (method === "GET" || method === "HEAD") {
+        for (const [key, value] of Object.entries(args)) {
+          if (value !== void 0 && value !== null) {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      } else {
+        const bodyArgs = {};
+        for (const [key, value] of Object.entries(args)) {
+          if (value === void 0 || value === null) continue;
+          const paramDef = cap.parameters?.find((p) => p.name === key);
+          if (paramDef?.in === "query") {
+            url.searchParams.set(key, String(value));
+          } else {
+            bodyArgs[key] = value;
+          }
+        }
+        if (Object.keys(bodyArgs).length > 0) {
+          headers["Content-Type"] = "application/json";
+          body = JSON.stringify(bodyArgs);
+        }
+      }
+      try {
+        const response = await fetch(url.toString(), {
+          method,
+          headers,
+          body
+        });
+        const data = await response.text();
+        if (!response.ok) {
+          return {
+            content: [{
+              type: "text",
+              text: `Error: HTTP ${response.status} ${response.statusText}
+${data}`
+            }]
+          };
+        }
+        return {
+          content: [{ type: "text", text: data }]
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error calling ${cap.endpoint}: ${err instanceof Error ? err.message : "Unknown error"}`
+          }]
+        };
+      }
+    }
+  );
+}
+
+// src/cli.ts
+var targetUrl = process.argv[2];
+if (!targetUrl) {
+  console.error("Usage: agents-txt-mcp <url>");
+  console.error("Example: agents-txt-mcp https://example.com");
+  process.exit(1);
+}
+async function main() {
+  try {
+    const { server, document } = await createAgentsTxtServer(targetUrl);
+    console.error(`[agents-txt-mcp] Connected to: ${document.site.name}`);
+    console.error(`[agents-txt-mcp] Capabilities: ${document.capabilities.map((c) => c.id).join(", ")}`);
+    const transport = new import_stdio.StdioServerTransport();
+    await server.connect(transport);
+  } catch (err) {
+    console.error(`[agents-txt-mcp] Fatal:`, err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+main();

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  createAgentsTxtServer
+} from "./chunk-TLN4YSVV.js";
+
+// src/cli.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var targetUrl = process.argv[2];
+if (!targetUrl) {
+  console.error("Usage: agents-txt-mcp <url>");
+  console.error("Example: agents-txt-mcp https://example.com");
+  process.exit(1);
+}
+async function main() {
+  try {
+    const { server, document } = await createAgentsTxtServer(targetUrl);
+    console.error(`[agents-txt-mcp] Connected to: ${document.site.name}`);
+    console.error(`[agents-txt-mcp] Capabilities: ${document.capabilities.map((c) => c.id).join(", ")}`);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+  } catch (err) {
+    console.error(`[agents-txt-mcp] Fatal:`, err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}
+main();

package/dist/index.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createAgentsTxtServer: () => createAgentsTxtServer
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_core = require("@agents-txt/core");
+async function createAgentsTxtServer(targetUrl, options = {}) {
+  const client = new import_core.AgentsTxtClient();
+  let result = await client.discoverJSON(targetUrl);
+  if (!result.success) {
+    result = await client.discover(targetUrl);
+  }
+  if (!result.success || !result.document) {
+    throw new Error(
+      `Failed to discover agents.txt at ${targetUrl}: ${result.errors.map((e) => e.message).join(", ")}`
+    );
+  }
+  const doc = result.document;
+  const server = new import_mcp.McpServer({
+    name: `agents-txt: ${doc.site.name}`,
+    version: "0.1.0"
+  });
+  for (const cap of doc.capabilities) {
+    if (cap.protocol === "REST") {
+      registerRestTool(server, cap, options);
+    }
+  }
+  return { server, document: doc };
+}
+function buildAuthHeaders(cap, options) {
+  const headers = {};
+  if (!cap.auth || cap.auth.type === "none") return headers;
+  switch (cap.auth.type) {
+    case "bearer-token":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+    case "api-key":
+      if (options.apiKey) {
+        headers["X-API-Key"] = options.apiKey;
+      }
+      break;
+    case "oauth2":
+      if (options.bearerToken) {
+        headers["Authorization"] = `Bearer ${options.bearerToken}`;
+      }
+      break;
+  }
+  return headers;
+}
+function registerRestTool(server, cap, options) {
+  const properties = {};
+  const required = [];
+  if (cap.parameters) {
+    for (const param of cap.parameters) {
+      properties[param.name] = {
+        type: param.type === "integer" ? "number" : param.type,
+        description: param.description
+      };
+      if (param.required) required.push(param.name);
+    }
+  }
+  server.tool(
+    cap.id,
+    cap.description,
+    properties,
+    async (args) => {
+      const method = (cap.method ?? "GET").toUpperCase();
+      const url = new URL(cap.endpoint);
+      const authHeaders = buildAuthHeaders(cap, options);
+      const headers = {
+        "Accept": "application/json",
+        "User-Agent": "agents-txt-mcp/0.1",
+        ...authHeaders
+      };
+      let body;
+      if (method === "GET" || method === "HEAD") {
+        for (const [key, value] of Object.entries(args)) {
+          if (value !== void 0 && value !== null) {
+            url.searchParams.set(key, String(value));
+          }
+        }
+      } else {
+        const bodyArgs = {};
+        for (const [key, value] of Object.entries(args)) {
+          if (value === void 0 || value === null) continue;
+          const paramDef = cap.parameters?.find((p) => p.name === key);
+          if (paramDef?.in === "query") {
+            url.searchParams.set(key, String(value));
+          } else {
+            bodyArgs[key] = value;
+          }
+        }
+        if (Object.keys(bodyArgs).length > 0) {
+          headers["Content-Type"] = "application/json";
+          body = JSON.stringify(bodyArgs);
+        }
+      }
+      try {
+        const response = await fetch(url.toString(), {
+          method,
+          headers,
+          body
+        });
+        const data = await response.text();
+        if (!response.ok) {
+          return {
+            content: [{
+              type: "text",
+              text: `Error: HTTP ${response.status} ${response.statusText}
+${data}`
+            }]
+          };
+        }
+        return {
+          content: [{ type: "text", text: data }]
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: "text",
+            text: `Error calling ${cap.endpoint}: ${err instanceof Error ? err.message : "Unknown error"}`
+          }]
+        };
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAgentsTxtServer
+});

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { AgentsTxtDocument } from '@agents-txt/core';
+
+interface ServerOptions {
+    /** Bearer token for authenticated endpoints. */
+    bearerToken?: string;
+    /** API key for authenticated endpoints. */
+    apiKey?: string;
+}
+/**
+ * Create an MCP server that wraps an agents.txt-compliant website.
+ * Each declared capability becomes an MCP tool.
+ */
+declare function createAgentsTxtServer(targetUrl: string, options?: ServerOptions): Promise<{
+    server: McpServer;
+    document: AgentsTxtDocument;
+}>;
+
+export { type ServerOptions, createAgentsTxtServer };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { AgentsTxtDocument } from '@agents-txt/core';
+
+interface ServerOptions {
+    /** Bearer token for authenticated endpoints. */
+    bearerToken?: string;
+    /** API key for authenticated endpoints. */
+    apiKey?: string;
+}
+/**
+ * Create an MCP server that wraps an agents.txt-compliant website.
+ * Each declared capability becomes an MCP tool.
+ */
+declare function createAgentsTxtServer(targetUrl: string, options?: ServerOptions): Promise<{
+    server: McpServer;
+    document: AgentsTxtDocument;
+}>;
+
+export { type ServerOptions, createAgentsTxtServer };

package/dist/index.js

@@ -0,0 +1,6 @@
+import {
+  createAgentsTxtServer
+} from "./chunk-TLN4YSVV.js";
+export {
+  createAgentsTxtServer
+};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@agents-txt/mcp",
+  "version": "0.1.0",
+  "description": "MCP server that wraps any agents.txt-compliant website — instantly usable by Claude Desktop and other MCP clients",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agents-txt-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "agents.txt",
+    "agents-txt",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-desktop",
+    "ai-agents",
+    "llm",
+    "well-known",
+    "capability-declaration",
+    "web-standard",
+    "anthropic",
+    "openai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kaylacar/agents-txt.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/kaylacar/agents-txt",
+  "bugs": {
+    "url": "https://github.com/kaylacar/agents-txt/issues"
+  },
+  "dependencies": {
+    "@agents-txt/core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "express": "^5.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0",
+    "@agents-txt/express": "0.1.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}