Agent / foldkit-agent-mcp

foldkit-agent-mcp

Serves a foldkit-agent runtime over the Model Context Protocol (2025-06-18).

Use it when an external assistant or tool host should discover and invoke the same capabilities your Foldkit application already exposes. This package does not define tools independently. It maps the protocol-neutral agent contract onto MCP tools/resources and delegates every invocation back to the bound AgentRuntime.

Foldkit application
       |
       v
AssistantAgent              protocol-neutral contract
       |
       | AgentBuilder.bind(...)
       v
AgentRuntime                live Model + dispatch + policy
       |
       v
foldkit-agent-mcp           adapter
       |
       +---- stdio
       |
       +---- Streamable HTTP
       v
MCP client

The contract remains the authority. MCP adds transport, sessions, protocol error mapping, and discovery; it does not add application capabilities.

Install

bash

pnpm add foldkit-agent foldkit-agent-mcp

foldkit, effect, and foldkit-agent are peer dependencies.

Install#

Install