[mattzcarey]

Adds @cloudflare/forge-mcp: a TypeScript forge plugin that turns an OpenAPI document into an MCP tool catalogue (mcp-tools.json), and a runtime on the MCP TypeScript SDK that serves a catalogue over Streamable HTTP. The README spells out how methods become tools, as asked for on #49.

This is the TypeScript, HTTP-only counterpart to #49. A Worker on the TS SDK can serve the generated tools with its own auth in front, and the catalogue is plain data, so the same file could back other runtimes.

flowchart LR
  doc[openapi.forge.json] -->|"forge --target wasm://forge-mcp.wasm"| cat[mcp-tools.json]
  cat --> rt["createForgeMcpHandler<br/>tools/list · tools/call"]
  rt -->|one request per call| api[API]

Loading

• Plugin (src/tools.ts, src/schema.ts): one tool per non-deprecated method. Hidden methods are included, because a client can only call what tools/list returns. Each tool has the group path plus method name in snake case, a self-contained JSON Schema 2020-12 input with only the $defs it reaches, and hints from the HTTP method. Methods with a required non-JSON body are skipped and listed in skipped with the reason. catalogueFile(forge, { include, name, transform }) is the hook for writing your own plugin.
• Runtime (src/server.ts, src/request.ts): createForgeMcpHandler({ catalogue, authorize }) returns a fetch. tools/list is built once per catalogue, and tools/call substitutes path parameters, serializes the query in form style and sends body as JSON. A non-2xx response is an isError result. serveCatalogue puts the same tools on an existing server.
• Example (example/): a Worker serving the Cloudflare API. pnpm example:generate runs the plugin on the latest openapi.forge.json.

const mcp = createForgeMcpHandler({
  catalogue,
  authorize: (request) => {
    const authorization = request.headers.get('Authorization');
    return authorization ? { Authorization: authorization } : new Response('Unauthorized', { status: 401 });
  },
});
export default { fetch: (request: Request) => mcp.fetch(request) };

On the latest Cloudflare release, the plugin writes 3,053 tools in about 1.5 s; 27 methods are skipped for non-JSON bodies. The example Worker is 671 KB gzipped. I connected the MCP TS client to it under wrangler dev: tools/list returned all 3,053 tools in 112 ms, and accounts_list and zones_list succeeded against the live API with an OAuth token. Unit tests ran (pnpm --filter @cloudflare/forge-mcp test).

[mattzcarey]

Closing for now. We'll keep working on this on a branch and try it in production behind ?forge=true on cloudflare/mcp before proposing anything here.