@agentskit/mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emerson Braun
+
+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/README.md

@@ -0,0 +1,60 @@
+# @agentskit/mcp
+
+Expose AgentsKit tools as an [MCP](https://modelcontextprotocol.io) server — use
+them from Claude Desktop, Cursor, Windsurf, or any MCP host.
+
+```bash
+npx @agentskit/mcp --tools fetch,search
+```
+
+Then point your MCP host at the command. Example (Claude Desktop config):
+
+```json
+{
+  "mcpServers": {
+    "agentskit": { "command": "npx", "args": ["@agentskit/mcp", "--tools", "fetch,search"] }
+  }
+}
+```
+
+## Flags
+
+| Flag | Effect |
+|------|--------|
+| `--tools <a,b>` | which tools to expose (default `fetch,search`). Available: `fetch`, `search`, `filesystem`, `shell`, `sqlite` |
+| `--fs-root <dir>` | enable the filesystem tool, rooted at `<dir>` |
+| `--sqlite <file>` | enable the sqlite query tool against `<file>` |
+| `--allow-shell` | enable the shell tool (off by default — it runs commands) |
+
+`stdout` is the MCP JSON-RPC channel; human output goes to `stderr`.
+
+## Programmatic
+
+```ts
+import { createAgentsKitMcpServer } from '@agentskit/mcp'
+import { fetchUrl } from '@agentskit/tools'
+
+createAgentsKitMcpServer({ tools: [fetchUrl()] }) // stdio by default
+```
+
+Pass `transport` to use a custom MCP transport (e.g. in-memory for tests).
+
+## Expose whole agents (agents as MCP tools)
+
+Run a registry agent server-side and expose it as a single MCP tool — the host
+delegates a specialized job instead of orchestrating primitives:
+
+```bash
+npx @agentskit/mcp --agents legal-contract-reviewer,fintech-kyc-screener --provider openai
+```
+
+`--provider` covers the first-class adapters (openai, anthropic, gemini, ollama)
+plus the OpenAI-compatible set (deepseek, grok, groq, mistral, cohere, together,
+fireworks, openrouter, cerebras, kimi, huggingface, qwen, lmstudio, vllm, llamacpp)
+and any other OpenAI-compatible provider in the models.dev catalog. Key from
+`--api-key` or `<PROVIDER>_API_KEY`; `--model` / `--base-url` optional.
+
+```ts
+import { createAgentTool } from '@agentskit/mcp'
+createAgentsKitMcpServer({ tools: [createAgentTool({ id, description, systemPrompt, adapter })] })
+```

package/dist/bin.cjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+'use strict';
+
+var tools = require('@agentskit/tools');
+var adapters = require('@agentskit/adapters');
+var catalog = require('@agentskit/adapters/catalog');
+var mcp = require('@agentskit/tools/mcp');
+var runtime = require('@agentskit/runtime');
+
+function createAgentTool(config) {
+  const skill = {
+    name: config.id,
+    description: config.description,
+    systemPrompt: config.systemPrompt
+  };
+  return {
+    name: config.id,
+    description: config.description,
+    schema: {
+      type: "object",
+      properties: { task: { type: "string", description: "The task or input for the agent." } },
+      required: ["task"]
+    },
+    execute: async (args) => {
+      const runtime$1 = runtime.createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 });
+      const result = await runtime$1.run(String(args.task ?? ""), { skill });
+      return { content: result.content, steps: result.steps };
+    }
+  };
+}
+
+// src/registry-fetch.ts
+var HOSTED = "https://registry.agentskit.io/r";
+var RAW = "https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main";
+async function fetchAgentSkill(id, fetchImpl = globalThis.fetch) {
+  const tryUrl = async (url) => {
+    try {
+      const res = await fetchImpl(url);
+      return res.ok ? await res.json() : null;
+    } catch {
+      return null;
+    }
+  };
+  const hosted = await tryUrl(`${HOSTED}/${id}.json`);
+  if (hosted?.skill?.systemPrompt) {
+    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt };
+  }
+  const meta = await tryUrl(`${RAW}/registry/${id}/meta.json`);
+  if (!meta) return null;
+  let src = null;
+  try {
+    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`);
+    src = res.ok ? await res.text() : null;
+  } catch {
+    src = null;
+  }
+  if (!src) return null;
+  const m = src.match(/systemPrompt:\s*`((?:\\.|[^`\\])*)`/);
+  if (!m) return null;
+  return {
+    id,
+    description: meta.description ?? id,
+    systemPrompt: m[1].replace(/\\`/g, "`").replace(/\\\$\{/g, "${")
+  };
+}
+
+// src/index.ts
+function processStdio() {
+  return {
+    stdin: { write: (chunk) => void process.stdout.write(chunk) },
+    stdout: {
+      on: (_event, cb) => void process.stdin.on("data", cb),
+      off: (_event, cb) => void process.stdin.off("data", cb)
+    },
+    on: (event, cb) => void process.on(event === "close" ? "beforeExit" : "exit", cb)
+  };
+}
+function createAgentsKitMcpServer(options) {
+  const transport = options.transport ?? mcp.createStdioTransport(processStdio());
+  return mcp.createMcpServer({
+    transport,
+    tools: options.tools,
+    serverInfo: options.serverInfo ?? { name: "agentskit-mcp", version: "0.1.0" },
+    onEvent: options.onEvent
+  });
+}
+
+// src/bin.ts
+var warn = (msg) => process.stderr.write(`agentskit-mcp: ${msg}
+`);
+var flag = (name) => {
+  const i = process.argv.indexOf(name);
+  return i >= 0 ? process.argv[i + 1] : void 0;
+};
+var has = (name) => process.argv.includes(name);
+function buildTools() {
+  if (!has("--tools")) return [tools.fetchUrl(), tools.webSearch()];
+  const requested = (flag("--tools") ?? "").split(",").map((s) => s.trim());
+  const tools$1 = [];
+  if (requested.includes("fetch")) tools$1.push(tools.fetchUrl());
+  if (requested.includes("search")) tools$1.push(tools.webSearch());
+  if (requested.includes("filesystem")) {
+    const root = flag("--fs-root");
+    if (root) tools$1.push(...tools.filesystem({ basePath: root }));
+    else warn('skipping "filesystem": pass --fs-root <dir>');
+  }
+  if (requested.includes("sqlite")) {
+    const file = flag("--sqlite");
+    if (file) tools$1.push(tools.sqliteQueryTool({ path: file }));
+    else warn('skipping "sqlite": pass --sqlite <file>');
+  }
+  if (requested.includes("shell")) {
+    if (has("--allow-shell")) tools$1.push(tools.shell());
+    else warn('skipping "shell": pass --allow-shell (runs commands)');
+  }
+  return tools$1;
+}
+var KEYED = {
+  openai: adapters.openai,
+  anthropic: adapters.anthropic,
+  gemini: adapters.gemini,
+  deepseek: adapters.deepseek,
+  grok: adapters.grok,
+  groq: adapters.groq,
+  mistral: adapters.mistral,
+  cohere: adapters.cohere,
+  together: adapters.together,
+  fireworks: adapters.fireworks,
+  openrouter: adapters.openrouter,
+  cerebras: adapters.cerebras,
+  kimi: adapters.kimi,
+  huggingface: adapters.huggingface,
+  qwen: adapters.qwen,
+  lmstudio: adapters.lmstudio,
+  vllm: adapters.vllm,
+  llamacpp: adapters.llamacpp
+};
+var LOCAL = { ollama: adapters.ollama };
+var LOCAL_COMPAT = /* @__PURE__ */ new Set(["lmstudio", "vllm", "llamacpp"]);
+var DEFAULT_MODEL = {
+  openai: "gpt-4o",
+  anthropic: "claude-sonnet-4-6",
+  gemini: "gemini-2.0-flash",
+  deepseek: "deepseek-chat",
+  grok: "grok-2",
+  groq: "llama-3.3-70b-versatile",
+  mistral: "mistral-large-latest",
+  ollama: "llama3"
+};
+function resolveAdapter() {
+  const provider = flag("--provider") ?? "openai";
+  const model = flag("--model") ?? DEFAULT_MODEL[provider];
+  if (!model) {
+    warn(`--agents needs a model for "${provider}": pass --model`);
+    return null;
+  }
+  const baseUrl = flag("--base-url");
+  if (LOCAL[provider]) return LOCAL[provider]({ model, baseUrl });
+  const apiKey = flag("--api-key") ?? process.env[`${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`] ?? (LOCAL_COMPAT.has(provider) ? "local" : void 0);
+  if (!apiKey) {
+    warn(`--agents needs a key for "${provider}": pass --api-key or set ${provider.toUpperCase()}_API_KEY`);
+    return null;
+  }
+  if (KEYED[provider]) return KEYED[provider]({ apiKey, model });
+  try {
+    return catalog.dispatchFromCatalog({ provider, model, apiKey, baseUrl });
+  } catch {
+    warn(`unknown provider "${provider}". Known: ${[...Object.keys(KEYED), ...Object.keys(LOCAL)].join(", ")}, or any catalog OpenAI-compatible provider.`);
+    return null;
+  }
+}
+async function buildAgentTools() {
+  const ids = (flag("--agents") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  if (ids.length === 0) return [];
+  const adapter = resolveAdapter();
+  if (!adapter) return [];
+  const tools = [];
+  for (const id of ids) {
+    const skill = await fetchAgentSkill(id);
+    if (!skill) {
+      warn(`skipping agent "${id}": not found or not runnable (tool-composing agent)`);
+      continue;
+    }
+    tools.push(
+      createAgentTool({ id: skill.id, description: skill.description, systemPrompt: skill.systemPrompt, adapter })
+    );
+  }
+  return tools;
+}
+async function main() {
+  const tools = [...buildTools(), ...await buildAgentTools()];
+  if (tools.length === 0) {
+    warn("no tools or agents enabled \u2014 nothing to serve. See --tools / --agents.");
+    process.exit(1);
+  }
+  createAgentsKitMcpServer({
+    tools,
+    onEvent: (e) => {
+      if (e.type === "error") warn(`tool error (${e.tool}): ${e.error}`);
+    }
+  });
+  warn(`serving ${tools.length} item(s) over stdio (${tools.map((t) => t.name).join(", ")})`);
+}
+void main();
+//# sourceMappingURL=bin.cjs.map
+//# sourceMappingURL=bin.cjs.map

package/dist/bin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-tool.ts","../src/registry-fetch.ts","../src/index.ts","../src/bin.ts"],"names":["runtime","createRuntime","createStdioTransport","createMcpServer","fetchUrl","webSearch","tools","filesystem","sqliteQueryTool","shell","openai","anthropic","gemini","deepseek","grok","groq","mistral","cohere","together","fireworks","openrouter","cerebras","kimi","huggingface","qwen","lmstudio","vllm","llamacpp","ollama","dispatchFromCatalog"],"mappings":"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","file":"bin.cjs","sourcesContent":["import type { AdapterFactory, SkillDefinition, ToolDefinition } from '@agentskit/core'\nimport { createRuntime } from '@agentskit/runtime'\n\nexport interface AgentToolConfig {\n  /** Tool name exposed to the MCP host (the agent id). */\n  id: string\n  description: string\n  /** The agent's system prompt (its skill). */\n  systemPrompt: string\n  /** Model adapter the agent runs on (server-side). */\n  adapter: AdapterFactory\n  maxSteps?: number\n}\n\n/**\n * Wrap a whole agent as a single MCP tool. The MCP host calls it with a `task`\n * string; the agent runs server-side (its own skill + reasoning loop on the\n * provided adapter) and returns the result. This is \"agents as MCP tools\" — the\n * host delegates a specialized job rather than orchestrating primitives.\n */\nexport function createAgentTool(config: AgentToolConfig): ToolDefinition {\n  const skill: SkillDefinition = {\n    name: config.id,\n    description: config.description,\n    systemPrompt: config.systemPrompt,\n  }\n  return {\n    name: config.id,\n    description: config.description,\n    schema: {\n      type: 'object',\n      properties: { task: { type: 'string', description: 'The task or input for the agent.' } },\n      required: ['task'],\n    },\n    execute: async (args: Record<string, unknown>) => {\n      const runtime = createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 })\n      const result = await runtime.run(String(args.task ?? ''), { skill })\n      return { content: result.content, steps: result.steps }\n    },\n  }\n}\n","const HOSTED = 'https://registry.agentskit.io/r'\nconst RAW = 'https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main'\n\nexport interface FetchedAgentSkill {\n  id: string\n  description: string\n  systemPrompt: string\n}\n\n/**\n * Fetch a registry agent's runnable skill (id, description, systemPrompt) so it\n * can be exposed as an MCP tool. Hosted index first, raw-GitHub fallback. Returns\n * null for tool-composing agents (no inline prompt) or unknown ids.\n */\nexport async function fetchAgentSkill(\n  id: string,\n  fetchImpl: typeof fetch = globalThis.fetch,\n): Promise<FetchedAgentSkill | null> {\n  const tryUrl = async (url: string): Promise<unknown | null> => {\n    try {\n      const res = await fetchImpl(url)\n      return res.ok ? await res.json() : null\n    } catch {\n      return null\n    }\n  }\n\n  const hosted = (await tryUrl(`${HOSTED}/${id}.json`)) as\n    | { description?: string; skill?: { systemPrompt?: string } | null }\n    | null\n  if (hosted?.skill?.systemPrompt) {\n    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt }\n  }\n\n  // Fallback: extract the inline skill from the raw agent.ts source.\n  const meta = (await tryUrl(`${RAW}/registry/${id}/meta.json`)) as { description?: string } | null\n  if (!meta) return null\n  let src: string | null = null\n  try {\n    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`)\n    src = res.ok ? await res.text() : null\n  } catch {\n    src = null\n  }\n  if (!src) return null\n  const m = src.match(/systemPrompt:\\s*`((?:\\\\.|[^`\\\\])*)`/)\n  if (!m) return null\n  return {\n    id,\n    description: meta.description ?? id,\n    systemPrompt: m[1].replace(/\\\\`/g, '`').replace(/\\\\\\$\\{/g, '${'),\n  }\n}\n","import type { ToolDefinition } from '@agentskit/core'\nimport {\n  createMcpServer,\n  createStdioTransport,\n  type McpServer,\n  type McpTransport,\n  type StdioLikeProcess,\n} from '@agentskit/tools/mcp'\n\nexport interface AgentsKitMcpServerOptions {\n  /** AgentsKit tools to expose to the MCP host. */\n  tools: ToolDefinition[]\n  serverInfo?: { name: string; version: string }\n  /** Observability hook (call / error / list). Logs must NOT go to stdout — it is the MCP channel. */\n  onEvent?: (event: { type: 'call' | 'error' | 'list'; tool?: string; error?: string }) => void\n  /**\n   * Transport override. Defaults to stdio over the current process (the form\n   * Claude Desktop / Cursor / Windsurf launch). Inject a custom transport for tests.\n   */\n  transport?: McpTransport\n}\n\n/**\n * Adapt the current Node process to the `StdioLikeProcess` the transport expects:\n * the server RECEIVES JSON-RPC on stdin and SENDS on stdout.\n */\nexport function processStdio(): StdioLikeProcess {\n  return {\n    stdin: { write: (chunk: string) => void process.stdout.write(chunk) },\n    stdout: {\n      on: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.on('data', cb),\n      off: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.off('data', cb),\n    },\n    on: (event: 'exit' | 'close', cb: () => void) =>\n      void process.on(event === 'close' ? 'beforeExit' : 'exit', cb),\n  }\n}\n\n/**\n * Expose a set of AgentsKit tools as an MCP server (over stdio by default), so\n * any MCP host — Claude Desktop, Cursor, Windsurf — can call them.\n */\nexport function createAgentsKitMcpServer(options: AgentsKitMcpServerOptions): McpServer {\n  const transport = options.transport ?? createStdioTransport(processStdio())\n  return createMcpServer({\n    transport,\n    tools: options.tools,\n    serverInfo: options.serverInfo ?? { name: 'agentskit-mcp', version: '0.1.0' },\n    onEvent: options.onEvent,\n  })\n}\n\nexport { createAgentTool, type AgentToolConfig } from './agent-tool'\nexport { fetchAgentSkill, type FetchedAgentSkill } from './registry-fetch'\nexport type { McpServer, McpTransport } from '@agentskit/tools/mcp'\n","#!/usr/bin/env node\nimport type { AdapterFactory, ToolDefinition } from '@agentskit/core'\nimport { fetchUrl, webSearch, filesystem, shell, sqliteQueryTool } from '@agentskit/tools'\nimport {\n  anthropic, gemini, openai, deepseek, grok, groq, mistral, cohere, together,\n  fireworks, openrouter, cerebras, kimi, huggingface, qwen,\n  ollama, lmstudio, vllm, llamacpp,\n} from '@agentskit/adapters'\nimport { dispatchFromCatalog } from '@agentskit/adapters/catalog'\nimport { createAgentsKitMcpServer } from './index'\nimport { createAgentTool } from './agent-tool'\nimport { fetchAgentSkill } from './registry-fetch'\n\n/**\n * `agentskit-mcp` — start an MCP server exposing AgentsKit tools and/or agents.\n *\n *   --tools <a,b>     primitive tools (default: fetch,search; also filesystem/shell/sqlite)\n *   --fs-root <dir>   root for the filesystem tool\n *   --sqlite <file>   database file for the sqlite tool\n *   --allow-shell     enable the shell tool\n *   --agents <a,b>    expose registry agents as tools (each runs server-side)\n *   --provider <p>    model for --agents: openai | anthropic | gemini | ollama (default openai)\n *   --model <m>       model name for --agents\n *   --api-key <k>     key for --agents (else the provider's env var)\n *\n * stdout is the MCP JSON-RPC channel; all human output goes to stderr.\n */\nconst warn = (msg: string) => process.stderr.write(`agentskit-mcp: ${msg}\\n`)\nconst flag = (name: string): string | undefined => {\n  const i = process.argv.indexOf(name)\n  return i >= 0 ? process.argv[i + 1] : undefined\n}\nconst has = (name: string): boolean => process.argv.includes(name)\n\nfunction buildTools(): ToolDefinition[] {\n  if (!has('--tools')) return [fetchUrl(), webSearch()]\n  const requested = (flag('--tools') ?? '').split(',').map((s) => s.trim())\n  const tools: ToolDefinition[] = []\n  if (requested.includes('fetch')) tools.push(fetchUrl())\n  if (requested.includes('search')) tools.push(webSearch())\n  if (requested.includes('filesystem')) {\n    const root = flag('--fs-root')\n    if (root) tools.push(...filesystem({ basePath: root }))\n    else warn('skipping \"filesystem\": pass --fs-root <dir>')\n  }\n  if (requested.includes('sqlite')) {\n    const file = flag('--sqlite')\n    if (file) tools.push(sqliteQueryTool({ path: file }))\n    else warn('skipping \"sqlite\": pass --sqlite <file>')\n  }\n  if (requested.includes('shell')) {\n    if (has('--allow-shell')) tools.push(shell())\n    else warn('skipping \"shell\": pass --allow-shell (runs commands)')\n  }\n  return tools\n}\n\ntype KeyedFactory = (cfg: { apiKey: string; model: string; baseUrl?: string }) => AdapterFactory\ntype LocalFactory = (cfg: { model: string; baseUrl?: string }) => AdapterFactory\n\n/** Providers that take { apiKey, model } — first-class + OpenAI-compatible (hosted + local-OpenAI-compat). */\nconst KEYED: Record<string, KeyedFactory> = {\n  openai, anthropic, gemini, deepseek, grok, groq, mistral, cohere, together,\n  fireworks, openrouter, cerebras, kimi, huggingface, qwen,\n  lmstudio, vllm, llamacpp,\n}\n/** Local providers whose adapter needs no key. */\nconst LOCAL: Record<string, LocalFactory> = { ollama }\n/** Local OpenAI-compatible servers — key is a placeholder. */\nconst LOCAL_COMPAT = new Set(['lmstudio', 'vllm', 'llamacpp'])\n\nconst DEFAULT_MODEL: Record<string, string> = {\n  openai: 'gpt-4o', anthropic: 'claude-sonnet-4-6', gemini: 'gemini-2.0-flash',\n  deepseek: 'deepseek-chat', grok: 'grok-2', groq: 'llama-3.3-70b-versatile',\n  mistral: 'mistral-large-latest', ollama: 'llama3',\n}\n\nfunction resolveAdapter(): AdapterFactory | null {\n  const provider = flag('--provider') ?? 'openai'\n  const model = flag('--model') ?? DEFAULT_MODEL[provider]\n  if (!model) {\n    warn(`--agents needs a model for \"${provider}\": pass --model`)\n    return null\n  }\n  const baseUrl = flag('--base-url')\n\n  if (LOCAL[provider]) return LOCAL[provider]({ model, baseUrl })\n\n  const apiKey =\n    flag('--api-key') ??\n    process.env[`${provider.toUpperCase().replace(/-/g, '_')}_API_KEY`] ??\n    (LOCAL_COMPAT.has(provider) ? 'local' : undefined)\n  if (!apiKey) {\n    warn(`--agents needs a key for \"${provider}\": pass --api-key or set ${provider.toUpperCase()}_API_KEY`)\n    return null\n  }\n  if (KEYED[provider]) return KEYED[provider]({ apiKey, model })\n\n  // Long tail: any other OpenAI-compatible provider in the models.dev catalog.\n  try {\n    return dispatchFromCatalog({ provider, model, apiKey, baseUrl })\n  } catch {\n    warn(`unknown provider \"${provider}\". Known: ${[...Object.keys(KEYED), ...Object.keys(LOCAL)].join(', ')}, or any catalog OpenAI-compatible provider.`)\n    return null\n  }\n}\n\nasync function buildAgentTools(): Promise<ToolDefinition[]> {\n  const ids = (flag('--agents') ?? '').split(',').map((s) => s.trim()).filter(Boolean)\n  if (ids.length === 0) return []\n  const adapter = resolveAdapter()\n  if (!adapter) return []\n  const tools: ToolDefinition[] = []\n  for (const id of ids) {\n    const skill = await fetchAgentSkill(id)\n    if (!skill) {\n      warn(`skipping agent \"${id}\": not found or not runnable (tool-composing agent)`)\n      continue\n    }\n    tools.push(\n      createAgentTool({ id: skill.id, description: skill.description, systemPrompt: skill.systemPrompt, adapter }),\n    )\n  }\n  return tools\n}\n\nasync function main(): Promise<void> {\n  const tools = [...buildTools(), ...(await buildAgentTools())]\n  if (tools.length === 0) {\n    warn('no tools or agents enabled — nothing to serve. See --tools / --agents.')\n    process.exit(1)\n  }\n  createAgentsKitMcpServer({\n    tools,\n    onEvent: (e) => {\n      if (e.type === 'error') warn(`tool error (${e.tool}): ${e.error}`)\n    },\n  })\n  warn(`serving ${tools.length} item(s) over stdio (${tools.map((t) => t.name).join(', ')})`)\n}\n\nvoid main()\n"]}

package/dist/bin.d.cts

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

package/dist/bin.d.ts

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

package/dist/bin.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { createAgentsKitMcpServer, fetchAgentSkill, createAgentTool } from './chunk-F5SVUT7Z.js';
+import { fetchUrl, webSearch, filesystem, sqliteQueryTool, shell } from '@agentskit/tools';
+import { ollama, llamacpp, vllm, lmstudio, qwen, huggingface, kimi, cerebras, openrouter, fireworks, together, cohere, mistral, groq, grok, deepseek, gemini, anthropic, openai } from '@agentskit/adapters';
+import { dispatchFromCatalog } from '@agentskit/adapters/catalog';
+
+var warn = (msg) => process.stderr.write(`agentskit-mcp: ${msg}
+`);
+var flag = (name) => {
+  const i = process.argv.indexOf(name);
+  return i >= 0 ? process.argv[i + 1] : void 0;
+};
+var has = (name) => process.argv.includes(name);
+function buildTools() {
+  if (!has("--tools")) return [fetchUrl(), webSearch()];
+  const requested = (flag("--tools") ?? "").split(",").map((s) => s.trim());
+  const tools = [];
+  if (requested.includes("fetch")) tools.push(fetchUrl());
+  if (requested.includes("search")) tools.push(webSearch());
+  if (requested.includes("filesystem")) {
+    const root = flag("--fs-root");
+    if (root) tools.push(...filesystem({ basePath: root }));
+    else warn('skipping "filesystem": pass --fs-root <dir>');
+  }
+  if (requested.includes("sqlite")) {
+    const file = flag("--sqlite");
+    if (file) tools.push(sqliteQueryTool({ path: file }));
+    else warn('skipping "sqlite": pass --sqlite <file>');
+  }
+  if (requested.includes("shell")) {
+    if (has("--allow-shell")) tools.push(shell());
+    else warn('skipping "shell": pass --allow-shell (runs commands)');
+  }
+  return tools;
+}
+var KEYED = {
+  openai,
+  anthropic,
+  gemini,
+  deepseek,
+  grok,
+  groq,
+  mistral,
+  cohere,
+  together,
+  fireworks,
+  openrouter,
+  cerebras,
+  kimi,
+  huggingface,
+  qwen,
+  lmstudio,
+  vllm,
+  llamacpp
+};
+var LOCAL = { ollama };
+var LOCAL_COMPAT = /* @__PURE__ */ new Set(["lmstudio", "vllm", "llamacpp"]);
+var DEFAULT_MODEL = {
+  openai: "gpt-4o",
+  anthropic: "claude-sonnet-4-6",
+  gemini: "gemini-2.0-flash",
+  deepseek: "deepseek-chat",
+  grok: "grok-2",
+  groq: "llama-3.3-70b-versatile",
+  mistral: "mistral-large-latest",
+  ollama: "llama3"
+};
+function resolveAdapter() {
+  const provider = flag("--provider") ?? "openai";
+  const model = flag("--model") ?? DEFAULT_MODEL[provider];
+  if (!model) {
+    warn(`--agents needs a model for "${provider}": pass --model`);
+    return null;
+  }
+  const baseUrl = flag("--base-url");
+  if (LOCAL[provider]) return LOCAL[provider]({ model, baseUrl });
+  const apiKey = flag("--api-key") ?? process.env[`${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`] ?? (LOCAL_COMPAT.has(provider) ? "local" : void 0);
+  if (!apiKey) {
+    warn(`--agents needs a key for "${provider}": pass --api-key or set ${provider.toUpperCase()}_API_KEY`);
+    return null;
+  }
+  if (KEYED[provider]) return KEYED[provider]({ apiKey, model });
+  try {
+    return dispatchFromCatalog({ provider, model, apiKey, baseUrl });
+  } catch {
+    warn(`unknown provider "${provider}". Known: ${[...Object.keys(KEYED), ...Object.keys(LOCAL)].join(", ")}, or any catalog OpenAI-compatible provider.`);
+    return null;
+  }
+}
+async function buildAgentTools() {
+  const ids = (flag("--agents") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  if (ids.length === 0) return [];
+  const adapter = resolveAdapter();
+  if (!adapter) return [];
+  const tools = [];
+  for (const id of ids) {
+    const skill = await fetchAgentSkill(id);
+    if (!skill) {
+      warn(`skipping agent "${id}": not found or not runnable (tool-composing agent)`);
+      continue;
+    }
+    tools.push(
+      createAgentTool({ id: skill.id, description: skill.description, systemPrompt: skill.systemPrompt, adapter })
+    );
+  }
+  return tools;
+}
+async function main() {
+  const tools = [...buildTools(), ...await buildAgentTools()];
+  if (tools.length === 0) {
+    warn("no tools or agents enabled \u2014 nothing to serve. See --tools / --agents.");
+    process.exit(1);
+  }
+  createAgentsKitMcpServer({
+    tools,
+    onEvent: (e) => {
+      if (e.type === "error") warn(`tool error (${e.tool}): ${e.error}`);
+    }
+  });
+  warn(`serving ${tools.length} item(s) over stdio (${tools.map((t) => t.name).join(", ")})`);
+}
+void main();
+//# sourceMappingURL=bin.js.map
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"names":[],"mappings":"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","file":"bin.js","sourcesContent":["#!/usr/bin/env node\nimport type { AdapterFactory, ToolDefinition } from '@agentskit/core'\nimport { fetchUrl, webSearch, filesystem, shell, sqliteQueryTool } from '@agentskit/tools'\nimport {\n  anthropic, gemini, openai, deepseek, grok, groq, mistral, cohere, together,\n  fireworks, openrouter, cerebras, kimi, huggingface, qwen,\n  ollama, lmstudio, vllm, llamacpp,\n} from '@agentskit/adapters'\nimport { dispatchFromCatalog } from '@agentskit/adapters/catalog'\nimport { createAgentsKitMcpServer } from './index'\nimport { createAgentTool } from './agent-tool'\nimport { fetchAgentSkill } from './registry-fetch'\n\n/**\n * `agentskit-mcp` — start an MCP server exposing AgentsKit tools and/or agents.\n *\n *   --tools <a,b>     primitive tools (default: fetch,search; also filesystem/shell/sqlite)\n *   --fs-root <dir>   root for the filesystem tool\n *   --sqlite <file>   database file for the sqlite tool\n *   --allow-shell     enable the shell tool\n *   --agents <a,b>    expose registry agents as tools (each runs server-side)\n *   --provider <p>    model for --agents: openai | anthropic | gemini | ollama (default openai)\n *   --model <m>       model name for --agents\n *   --api-key <k>     key for --agents (else the provider's env var)\n *\n * stdout is the MCP JSON-RPC channel; all human output goes to stderr.\n */\nconst warn = (msg: string) => process.stderr.write(`agentskit-mcp: ${msg}\\n`)\nconst flag = (name: string): string | undefined => {\n  const i = process.argv.indexOf(name)\n  return i >= 0 ? process.argv[i + 1] : undefined\n}\nconst has = (name: string): boolean => process.argv.includes(name)\n\nfunction buildTools(): ToolDefinition[] {\n  if (!has('--tools')) return [fetchUrl(), webSearch()]\n  const requested = (flag('--tools') ?? '').split(',').map((s) => s.trim())\n  const tools: ToolDefinition[] = []\n  if (requested.includes('fetch')) tools.push(fetchUrl())\n  if (requested.includes('search')) tools.push(webSearch())\n  if (requested.includes('filesystem')) {\n    const root = flag('--fs-root')\n    if (root) tools.push(...filesystem({ basePath: root }))\n    else warn('skipping \"filesystem\": pass --fs-root <dir>')\n  }\n  if (requested.includes('sqlite')) {\n    const file = flag('--sqlite')\n    if (file) tools.push(sqliteQueryTool({ path: file }))\n    else warn('skipping \"sqlite\": pass --sqlite <file>')\n  }\n  if (requested.includes('shell')) {\n    if (has('--allow-shell')) tools.push(shell())\n    else warn('skipping \"shell\": pass --allow-shell (runs commands)')\n  }\n  return tools\n}\n\ntype KeyedFactory = (cfg: { apiKey: string; model: string; baseUrl?: string }) => AdapterFactory\ntype LocalFactory = (cfg: { model: string; baseUrl?: string }) => AdapterFactory\n\n/** Providers that take { apiKey, model } — first-class + OpenAI-compatible (hosted + local-OpenAI-compat). */\nconst KEYED: Record<string, KeyedFactory> = {\n  openai, anthropic, gemini, deepseek, grok, groq, mistral, cohere, together,\n  fireworks, openrouter, cerebras, kimi, huggingface, qwen,\n  lmstudio, vllm, llamacpp,\n}\n/** Local providers whose adapter needs no key. */\nconst LOCAL: Record<string, LocalFactory> = { ollama }\n/** Local OpenAI-compatible servers — key is a placeholder. */\nconst LOCAL_COMPAT = new Set(['lmstudio', 'vllm', 'llamacpp'])\n\nconst DEFAULT_MODEL: Record<string, string> = {\n  openai: 'gpt-4o', anthropic: 'claude-sonnet-4-6', gemini: 'gemini-2.0-flash',\n  deepseek: 'deepseek-chat', grok: 'grok-2', groq: 'llama-3.3-70b-versatile',\n  mistral: 'mistral-large-latest', ollama: 'llama3',\n}\n\nfunction resolveAdapter(): AdapterFactory | null {\n  const provider = flag('--provider') ?? 'openai'\n  const model = flag('--model') ?? DEFAULT_MODEL[provider]\n  if (!model) {\n    warn(`--agents needs a model for \"${provider}\": pass --model`)\n    return null\n  }\n  const baseUrl = flag('--base-url')\n\n  if (LOCAL[provider]) return LOCAL[provider]({ model, baseUrl })\n\n  const apiKey =\n    flag('--api-key') ??\n    process.env[`${provider.toUpperCase().replace(/-/g, '_')}_API_KEY`] ??\n    (LOCAL_COMPAT.has(provider) ? 'local' : undefined)\n  if (!apiKey) {\n    warn(`--agents needs a key for \"${provider}\": pass --api-key or set ${provider.toUpperCase()}_API_KEY`)\n    return null\n  }\n  if (KEYED[provider]) return KEYED[provider]({ apiKey, model })\n\n  // Long tail: any other OpenAI-compatible provider in the models.dev catalog.\n  try {\n    return dispatchFromCatalog({ provider, model, apiKey, baseUrl })\n  } catch {\n    warn(`unknown provider \"${provider}\". Known: ${[...Object.keys(KEYED), ...Object.keys(LOCAL)].join(', ')}, or any catalog OpenAI-compatible provider.`)\n    return null\n  }\n}\n\nasync function buildAgentTools(): Promise<ToolDefinition[]> {\n  const ids = (flag('--agents') ?? '').split(',').map((s) => s.trim()).filter(Boolean)\n  if (ids.length === 0) return []\n  const adapter = resolveAdapter()\n  if (!adapter) return []\n  const tools: ToolDefinition[] = []\n  for (const id of ids) {\n    const skill = await fetchAgentSkill(id)\n    if (!skill) {\n      warn(`skipping agent \"${id}\": not found or not runnable (tool-composing agent)`)\n      continue\n    }\n    tools.push(\n      createAgentTool({ id: skill.id, description: skill.description, systemPrompt: skill.systemPrompt, adapter }),\n    )\n  }\n  return tools\n}\n\nasync function main(): Promise<void> {\n  const tools = [...buildTools(), ...(await buildAgentTools())]\n  if (tools.length === 0) {\n    warn('no tools or agents enabled — nothing to serve. See --tools / --agents.')\n    process.exit(1)\n  }\n  createAgentsKitMcpServer({\n    tools,\n    onEvent: (e) => {\n      if (e.type === 'error') warn(`tool error (${e.tool}): ${e.error}`)\n    },\n  })\n  warn(`serving ${tools.length} item(s) over stdio (${tools.map((t) => t.name).join(', ')})`)\n}\n\nvoid main()\n"]}

package/dist/chunk-F5SVUT7Z.js

@@ -0,0 +1,85 @@
+import { createStdioTransport, createMcpServer } from '@agentskit/tools/mcp';
+import { createRuntime } from '@agentskit/runtime';
+
+// src/index.ts
+function createAgentTool(config) {
+  const skill = {
+    name: config.id,
+    description: config.description,
+    systemPrompt: config.systemPrompt
+  };
+  return {
+    name: config.id,
+    description: config.description,
+    schema: {
+      type: "object",
+      properties: { task: { type: "string", description: "The task or input for the agent." } },
+      required: ["task"]
+    },
+    execute: async (args) => {
+      const runtime = createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 });
+      const result = await runtime.run(String(args.task ?? ""), { skill });
+      return { content: result.content, steps: result.steps };
+    }
+  };
+}
+
+// src/registry-fetch.ts
+var HOSTED = "https://registry.agentskit.io/r";
+var RAW = "https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main";
+async function fetchAgentSkill(id, fetchImpl = globalThis.fetch) {
+  const tryUrl = async (url) => {
+    try {
+      const res = await fetchImpl(url);
+      return res.ok ? await res.json() : null;
+    } catch {
+      return null;
+    }
+  };
+  const hosted = await tryUrl(`${HOSTED}/${id}.json`);
+  if (hosted?.skill?.systemPrompt) {
+    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt };
+  }
+  const meta = await tryUrl(`${RAW}/registry/${id}/meta.json`);
+  if (!meta) return null;
+  let src = null;
+  try {
+    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`);
+    src = res.ok ? await res.text() : null;
+  } catch {
+    src = null;
+  }
+  if (!src) return null;
+  const m = src.match(/systemPrompt:\s*`((?:\\.|[^`\\])*)`/);
+  if (!m) return null;
+  return {
+    id,
+    description: meta.description ?? id,
+    systemPrompt: m[1].replace(/\\`/g, "`").replace(/\\\$\{/g, "${")
+  };
+}
+
+// src/index.ts
+function processStdio() {
+  return {
+    stdin: { write: (chunk) => void process.stdout.write(chunk) },
+    stdout: {
+      on: (_event, cb) => void process.stdin.on("data", cb),
+      off: (_event, cb) => void process.stdin.off("data", cb)
+    },
+    on: (event, cb) => void process.on(event === "close" ? "beforeExit" : "exit", cb)
+  };
+}
+function createAgentsKitMcpServer(options) {
+  const transport = options.transport ?? createStdioTransport(processStdio());
+  return createMcpServer({
+    transport,
+    tools: options.tools,
+    serverInfo: options.serverInfo ?? { name: "agentskit-mcp", version: "0.1.0" },
+    onEvent: options.onEvent
+  });
+}
+
+export { createAgentTool, createAgentsKitMcpServer, fetchAgentSkill, processStdio };
+//# sourceMappingURL=chunk-F5SVUT7Z.js.map
+//# sourceMappingURL=chunk-F5SVUT7Z.js.map

package/dist/chunk-F5SVUT7Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-tool.ts","../src/registry-fetch.ts","../src/index.ts"],"names":[],"mappings":"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","file":"chunk-F5SVUT7Z.js","sourcesContent":["import type { AdapterFactory, SkillDefinition, ToolDefinition } from '@agentskit/core'\nimport { createRuntime } from '@agentskit/runtime'\n\nexport interface AgentToolConfig {\n  /** Tool name exposed to the MCP host (the agent id). */\n  id: string\n  description: string\n  /** The agent's system prompt (its skill). */\n  systemPrompt: string\n  /** Model adapter the agent runs on (server-side). */\n  adapter: AdapterFactory\n  maxSteps?: number\n}\n\n/**\n * Wrap a whole agent as a single MCP tool. The MCP host calls it with a `task`\n * string; the agent runs server-side (its own skill + reasoning loop on the\n * provided adapter) and returns the result. This is \"agents as MCP tools\" — the\n * host delegates a specialized job rather than orchestrating primitives.\n */\nexport function createAgentTool(config: AgentToolConfig): ToolDefinition {\n  const skill: SkillDefinition = {\n    name: config.id,\n    description: config.description,\n    systemPrompt: config.systemPrompt,\n  }\n  return {\n    name: config.id,\n    description: config.description,\n    schema: {\n      type: 'object',\n      properties: { task: { type: 'string', description: 'The task or input for the agent.' } },\n      required: ['task'],\n    },\n    execute: async (args: Record<string, unknown>) => {\n      const runtime = createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 })\n      const result = await runtime.run(String(args.task ?? ''), { skill })\n      return { content: result.content, steps: result.steps }\n    },\n  }\n}\n","const HOSTED = 'https://registry.agentskit.io/r'\nconst RAW = 'https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main'\n\nexport interface FetchedAgentSkill {\n  id: string\n  description: string\n  systemPrompt: string\n}\n\n/**\n * Fetch a registry agent's runnable skill (id, description, systemPrompt) so it\n * can be exposed as an MCP tool. Hosted index first, raw-GitHub fallback. Returns\n * null for tool-composing agents (no inline prompt) or unknown ids.\n */\nexport async function fetchAgentSkill(\n  id: string,\n  fetchImpl: typeof fetch = globalThis.fetch,\n): Promise<FetchedAgentSkill | null> {\n  const tryUrl = async (url: string): Promise<unknown | null> => {\n    try {\n      const res = await fetchImpl(url)\n      return res.ok ? await res.json() : null\n    } catch {\n      return null\n    }\n  }\n\n  const hosted = (await tryUrl(`${HOSTED}/${id}.json`)) as\n    | { description?: string; skill?: { systemPrompt?: string } | null }\n    | null\n  if (hosted?.skill?.systemPrompt) {\n    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt }\n  }\n\n  // Fallback: extract the inline skill from the raw agent.ts source.\n  const meta = (await tryUrl(`${RAW}/registry/${id}/meta.json`)) as { description?: string } | null\n  if (!meta) return null\n  let src: string | null = null\n  try {\n    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`)\n    src = res.ok ? await res.text() : null\n  } catch {\n    src = null\n  }\n  if (!src) return null\n  const m = src.match(/systemPrompt:\\s*`((?:\\\\.|[^`\\\\])*)`/)\n  if (!m) return null\n  return {\n    id,\n    description: meta.description ?? id,\n    systemPrompt: m[1].replace(/\\\\`/g, '`').replace(/\\\\\\$\\{/g, '${'),\n  }\n}\n","import type { ToolDefinition } from '@agentskit/core'\nimport {\n  createMcpServer,\n  createStdioTransport,\n  type McpServer,\n  type McpTransport,\n  type StdioLikeProcess,\n} from '@agentskit/tools/mcp'\n\nexport interface AgentsKitMcpServerOptions {\n  /** AgentsKit tools to expose to the MCP host. */\n  tools: ToolDefinition[]\n  serverInfo?: { name: string; version: string }\n  /** Observability hook (call / error / list). Logs must NOT go to stdout — it is the MCP channel. */\n  onEvent?: (event: { type: 'call' | 'error' | 'list'; tool?: string; error?: string }) => void\n  /**\n   * Transport override. Defaults to stdio over the current process (the form\n   * Claude Desktop / Cursor / Windsurf launch). Inject a custom transport for tests.\n   */\n  transport?: McpTransport\n}\n\n/**\n * Adapt the current Node process to the `StdioLikeProcess` the transport expects:\n * the server RECEIVES JSON-RPC on stdin and SENDS on stdout.\n */\nexport function processStdio(): StdioLikeProcess {\n  return {\n    stdin: { write: (chunk: string) => void process.stdout.write(chunk) },\n    stdout: {\n      on: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.on('data', cb),\n      off: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.off('data', cb),\n    },\n    on: (event: 'exit' | 'close', cb: () => void) =>\n      void process.on(event === 'close' ? 'beforeExit' : 'exit', cb),\n  }\n}\n\n/**\n * Expose a set of AgentsKit tools as an MCP server (over stdio by default), so\n * any MCP host — Claude Desktop, Cursor, Windsurf — can call them.\n */\nexport function createAgentsKitMcpServer(options: AgentsKitMcpServerOptions): McpServer {\n  const transport = options.transport ?? createStdioTransport(processStdio())\n  return createMcpServer({\n    transport,\n    tools: options.tools,\n    serverInfo: options.serverInfo ?? { name: 'agentskit-mcp', version: '0.1.0' },\n    onEvent: options.onEvent,\n  })\n}\n\nexport { createAgentTool, type AgentToolConfig } from './agent-tool'\nexport { fetchAgentSkill, type FetchedAgentSkill } from './registry-fetch'\nexport type { McpServer, McpTransport } from '@agentskit/tools/mcp'\n"]}

package/dist/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+var mcp = require('@agentskit/tools/mcp');
+var runtime = require('@agentskit/runtime');
+
+// src/index.ts
+function createAgentTool(config) {
+  const skill = {
+    name: config.id,
+    description: config.description,
+    systemPrompt: config.systemPrompt
+  };
+  return {
+    name: config.id,
+    description: config.description,
+    schema: {
+      type: "object",
+      properties: { task: { type: "string", description: "The task or input for the agent." } },
+      required: ["task"]
+    },
+    execute: async (args) => {
+      const runtime$1 = runtime.createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 });
+      const result = await runtime$1.run(String(args.task ?? ""), { skill });
+      return { content: result.content, steps: result.steps };
+    }
+  };
+}
+
+// src/registry-fetch.ts
+var HOSTED = "https://registry.agentskit.io/r";
+var RAW = "https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main";
+async function fetchAgentSkill(id, fetchImpl = globalThis.fetch) {
+  const tryUrl = async (url) => {
+    try {
+      const res = await fetchImpl(url);
+      return res.ok ? await res.json() : null;
+    } catch {
+      return null;
+    }
+  };
+  const hosted = await tryUrl(`${HOSTED}/${id}.json`);
+  if (hosted?.skill?.systemPrompt) {
+    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt };
+  }
+  const meta = await tryUrl(`${RAW}/registry/${id}/meta.json`);
+  if (!meta) return null;
+  let src = null;
+  try {
+    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`);
+    src = res.ok ? await res.text() : null;
+  } catch {
+    src = null;
+  }
+  if (!src) return null;
+  const m = src.match(/systemPrompt:\s*`((?:\\.|[^`\\])*)`/);
+  if (!m) return null;
+  return {
+    id,
+    description: meta.description ?? id,
+    systemPrompt: m[1].replace(/\\`/g, "`").replace(/\\\$\{/g, "${")
+  };
+}
+
+// src/index.ts
+function processStdio() {
+  return {
+    stdin: { write: (chunk) => void process.stdout.write(chunk) },
+    stdout: {
+      on: (_event, cb) => void process.stdin.on("data", cb),
+      off: (_event, cb) => void process.stdin.off("data", cb)
+    },
+    on: (event, cb) => void process.on(event === "close" ? "beforeExit" : "exit", cb)
+  };
+}
+function createAgentsKitMcpServer(options) {
+  const transport = options.transport ?? mcp.createStdioTransport(processStdio());
+  return mcp.createMcpServer({
+    transport,
+    tools: options.tools,
+    serverInfo: options.serverInfo ?? { name: "agentskit-mcp", version: "0.1.0" },
+    onEvent: options.onEvent
+  });
+}
+
+exports.createAgentTool = createAgentTool;
+exports.createAgentsKitMcpServer = createAgentsKitMcpServer;
+exports.fetchAgentSkill = fetchAgentSkill;
+exports.processStdio = processStdio;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-tool.ts","../src/registry-fetch.ts","../src/index.ts"],"names":["runtime","createRuntime","createStdioTransport","createMcpServer"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { AdapterFactory, SkillDefinition, ToolDefinition } from '@agentskit/core'\nimport { createRuntime } from '@agentskit/runtime'\n\nexport interface AgentToolConfig {\n  /** Tool name exposed to the MCP host (the agent id). */\n  id: string\n  description: string\n  /** The agent's system prompt (its skill). */\n  systemPrompt: string\n  /** Model adapter the agent runs on (server-side). */\n  adapter: AdapterFactory\n  maxSteps?: number\n}\n\n/**\n * Wrap a whole agent as a single MCP tool. The MCP host calls it with a `task`\n * string; the agent runs server-side (its own skill + reasoning loop on the\n * provided adapter) and returns the result. This is \"agents as MCP tools\" — the\n * host delegates a specialized job rather than orchestrating primitives.\n */\nexport function createAgentTool(config: AgentToolConfig): ToolDefinition {\n  const skill: SkillDefinition = {\n    name: config.id,\n    description: config.description,\n    systemPrompt: config.systemPrompt,\n  }\n  return {\n    name: config.id,\n    description: config.description,\n    schema: {\n      type: 'object',\n      properties: { task: { type: 'string', description: 'The task or input for the agent.' } },\n      required: ['task'],\n    },\n    execute: async (args: Record<string, unknown>) => {\n      const runtime = createRuntime({ adapter: config.adapter, maxSteps: config.maxSteps ?? 8 })\n      const result = await runtime.run(String(args.task ?? ''), { skill })\n      return { content: result.content, steps: result.steps }\n    },\n  }\n}\n","const HOSTED = 'https://registry.agentskit.io/r'\nconst RAW = 'https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main'\n\nexport interface FetchedAgentSkill {\n  id: string\n  description: string\n  systemPrompt: string\n}\n\n/**\n * Fetch a registry agent's runnable skill (id, description, systemPrompt) so it\n * can be exposed as an MCP tool. Hosted index first, raw-GitHub fallback. Returns\n * null for tool-composing agents (no inline prompt) or unknown ids.\n */\nexport async function fetchAgentSkill(\n  id: string,\n  fetchImpl: typeof fetch = globalThis.fetch,\n): Promise<FetchedAgentSkill | null> {\n  const tryUrl = async (url: string): Promise<unknown | null> => {\n    try {\n      const res = await fetchImpl(url)\n      return res.ok ? await res.json() : null\n    } catch {\n      return null\n    }\n  }\n\n  const hosted = (await tryUrl(`${HOSTED}/${id}.json`)) as\n    | { description?: string; skill?: { systemPrompt?: string } | null }\n    | null\n  if (hosted?.skill?.systemPrompt) {\n    return { id, description: hosted.description ?? id, systemPrompt: hosted.skill.systemPrompt }\n  }\n\n  // Fallback: extract the inline skill from the raw agent.ts source.\n  const meta = (await tryUrl(`${RAW}/registry/${id}/meta.json`)) as { description?: string } | null\n  if (!meta) return null\n  let src: string | null = null\n  try {\n    const res = await fetchImpl(`${RAW}/registry/${id}/agent.ts`)\n    src = res.ok ? await res.text() : null\n  } catch {\n    src = null\n  }\n  if (!src) return null\n  const m = src.match(/systemPrompt:\\s*`((?:\\\\.|[^`\\\\])*)`/)\n  if (!m) return null\n  return {\n    id,\n    description: meta.description ?? id,\n    systemPrompt: m[1].replace(/\\\\`/g, '`').replace(/\\\\\\$\\{/g, '${'),\n  }\n}\n","import type { ToolDefinition } from '@agentskit/core'\nimport {\n  createMcpServer,\n  createStdioTransport,\n  type McpServer,\n  type McpTransport,\n  type StdioLikeProcess,\n} from '@agentskit/tools/mcp'\n\nexport interface AgentsKitMcpServerOptions {\n  /** AgentsKit tools to expose to the MCP host. */\n  tools: ToolDefinition[]\n  serverInfo?: { name: string; version: string }\n  /** Observability hook (call / error / list). Logs must NOT go to stdout — it is the MCP channel. */\n  onEvent?: (event: { type: 'call' | 'error' | 'list'; tool?: string; error?: string }) => void\n  /**\n   * Transport override. Defaults to stdio over the current process (the form\n   * Claude Desktop / Cursor / Windsurf launch). Inject a custom transport for tests.\n   */\n  transport?: McpTransport\n}\n\n/**\n * Adapt the current Node process to the `StdioLikeProcess` the transport expects:\n * the server RECEIVES JSON-RPC on stdin and SENDS on stdout.\n */\nexport function processStdio(): StdioLikeProcess {\n  return {\n    stdin: { write: (chunk: string) => void process.stdout.write(chunk) },\n    stdout: {\n      on: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.on('data', cb),\n      off: (_event: 'data', cb: (chunk: Buffer | string) => void) => void process.stdin.off('data', cb),\n    },\n    on: (event: 'exit' | 'close', cb: () => void) =>\n      void process.on(event === 'close' ? 'beforeExit' : 'exit', cb),\n  }\n}\n\n/**\n * Expose a set of AgentsKit tools as an MCP server (over stdio by default), so\n * any MCP host — Claude Desktop, Cursor, Windsurf — can call them.\n */\nexport function createAgentsKitMcpServer(options: AgentsKitMcpServerOptions): McpServer {\n  const transport = options.transport ?? createStdioTransport(processStdio())\n  return createMcpServer({\n    transport,\n    tools: options.tools,\n    serverInfo: options.serverInfo ?? { name: 'agentskit-mcp', version: '0.1.0' },\n    onEvent: options.onEvent,\n  })\n}\n\nexport { createAgentTool, type AgentToolConfig } from './agent-tool'\nexport { fetchAgentSkill, type FetchedAgentSkill } from './registry-fetch'\nexport type { McpServer, McpTransport } from '@agentskit/tools/mcp'\n"]}

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+import { AdapterFactory, ToolDefinition } from '@agentskit/core';
+import { McpTransport, McpServer, StdioLikeProcess } from '@agentskit/tools/mcp';
+export { McpServer, McpTransport } from '@agentskit/tools/mcp';
+
+interface AgentToolConfig {
+    /** Tool name exposed to the MCP host (the agent id). */
+    id: string;
+    description: string;
+    /** The agent's system prompt (its skill). */
+    systemPrompt: string;
+    /** Model adapter the agent runs on (server-side). */
+    adapter: AdapterFactory;
+    maxSteps?: number;
+}
+/**
+ * Wrap a whole agent as a single MCP tool. The MCP host calls it with a `task`
+ * string; the agent runs server-side (its own skill + reasoning loop on the
+ * provided adapter) and returns the result. This is "agents as MCP tools" — the
+ * host delegates a specialized job rather than orchestrating primitives.
+ */
+declare function createAgentTool(config: AgentToolConfig): ToolDefinition;
+
+interface FetchedAgentSkill {
+    id: string;
+    description: string;
+    systemPrompt: string;
+}
+/**
+ * Fetch a registry agent's runnable skill (id, description, systemPrompt) so it
+ * can be exposed as an MCP tool. Hosted index first, raw-GitHub fallback. Returns
+ * null for tool-composing agents (no inline prompt) or unknown ids.
+ */
+declare function fetchAgentSkill(id: string, fetchImpl?: typeof fetch): Promise<FetchedAgentSkill | null>;
+
+interface AgentsKitMcpServerOptions {
+    /** AgentsKit tools to expose to the MCP host. */
+    tools: ToolDefinition[];
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Observability hook (call / error / list). Logs must NOT go to stdout — it is the MCP channel. */
+    onEvent?: (event: {
+        type: 'call' | 'error' | 'list';
+        tool?: string;
+        error?: string;
+    }) => void;
+    /**
+     * Transport override. Defaults to stdio over the current process (the form
+     * Claude Desktop / Cursor / Windsurf launch). Inject a custom transport for tests.
+     */
+    transport?: McpTransport;
+}
+/**
+ * Adapt the current Node process to the `StdioLikeProcess` the transport expects:
+ * the server RECEIVES JSON-RPC on stdin and SENDS on stdout.
+ */
+declare function processStdio(): StdioLikeProcess;
+/**
+ * Expose a set of AgentsKit tools as an MCP server (over stdio by default), so
+ * any MCP host — Claude Desktop, Cursor, Windsurf — can call them.
+ */
+declare function createAgentsKitMcpServer(options: AgentsKitMcpServerOptions): McpServer;
+
+export { type AgentToolConfig, type AgentsKitMcpServerOptions, type FetchedAgentSkill, createAgentTool, createAgentsKitMcpServer, fetchAgentSkill, processStdio };

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { AdapterFactory, ToolDefinition } from '@agentskit/core';
+import { McpTransport, McpServer, StdioLikeProcess } from '@agentskit/tools/mcp';
+export { McpServer, McpTransport } from '@agentskit/tools/mcp';
+
+interface AgentToolConfig {
+    /** Tool name exposed to the MCP host (the agent id). */
+    id: string;
+    description: string;
+    /** The agent's system prompt (its skill). */
+    systemPrompt: string;
+    /** Model adapter the agent runs on (server-side). */
+    adapter: AdapterFactory;
+    maxSteps?: number;
+}
+/**
+ * Wrap a whole agent as a single MCP tool. The MCP host calls it with a `task`
+ * string; the agent runs server-side (its own skill + reasoning loop on the
+ * provided adapter) and returns the result. This is "agents as MCP tools" — the
+ * host delegates a specialized job rather than orchestrating primitives.
+ */
+declare function createAgentTool(config: AgentToolConfig): ToolDefinition;
+
+interface FetchedAgentSkill {
+    id: string;
+    description: string;
+    systemPrompt: string;
+}
+/**
+ * Fetch a registry agent's runnable skill (id, description, systemPrompt) so it
+ * can be exposed as an MCP tool. Hosted index first, raw-GitHub fallback. Returns
+ * null for tool-composing agents (no inline prompt) or unknown ids.
+ */
+declare function fetchAgentSkill(id: string, fetchImpl?: typeof fetch): Promise<FetchedAgentSkill | null>;
+
+interface AgentsKitMcpServerOptions {
+    /** AgentsKit tools to expose to the MCP host. */
+    tools: ToolDefinition[];
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Observability hook (call / error / list). Logs must NOT go to stdout — it is the MCP channel. */
+    onEvent?: (event: {
+        type: 'call' | 'error' | 'list';
+        tool?: string;
+        error?: string;
+    }) => void;
+    /**
+     * Transport override. Defaults to stdio over the current process (the form
+     * Claude Desktop / Cursor / Windsurf launch). Inject a custom transport for tests.
+     */
+    transport?: McpTransport;
+}
+/**
+ * Adapt the current Node process to the `StdioLikeProcess` the transport expects:
+ * the server RECEIVES JSON-RPC on stdin and SENDS on stdout.
+ */
+declare function processStdio(): StdioLikeProcess;
+/**
+ * Expose a set of AgentsKit tools as an MCP server (over stdio by default), so
+ * any MCP host — Claude Desktop, Cursor, Windsurf — can call them.
+ */
+declare function createAgentsKitMcpServer(options: AgentsKitMcpServerOptions): McpServer;
+
+export { type AgentToolConfig, type AgentsKitMcpServerOptions, type FetchedAgentSkill, createAgentTool, createAgentsKitMcpServer, fetchAgentSkill, processStdio };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createAgentTool, createAgentsKitMcpServer, fetchAgentSkill, processStdio } from './chunk-F5SVUT7Z.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@agentskit/mcp",
+  "version": "0.2.0",
+  "description": "Expose AgentsKit tools as an MCP server — use them from Claude Desktop, Cursor, Windsurf, or any MCP host.",
+  "keywords": [
+    "agentskit",
+    "mcp",
+    "model-context-protocol",
+    "tools",
+    "ai",
+    "agents",
+    "claude",
+    "cursor"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agentskit-mcp": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agentskit/adapters": "0.13.0",
+    "@agentskit/core": "1.8.0",
+    "@agentskit/runtime": "0.8.0",
+    "@agentskit/tools": "0.10.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "homepage": "https://www.agentskit.io/docs/packages/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentsKit-io/agentskit.git",
+    "directory": "packages/mcp"
+  },
+  "author": "AgentsKit Contributors",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "dev": "tsup --watch"
+  }
+}