# ToolSchema Forge - MCP Manifest Generator

> ToolSchema Forge - MCP Manifest Generator is a paid API for AI agents from toolschema-forge.toolschemaforge.workers.dev, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-21).

Converts OpenAPI specs or raw tool definitions into a validated MCP manifest with LLM-provider-specific schema linting and a TypeScript server stub

## Facts

- Endpoint: POST https://toolschema-forge.toolschemaforge.workers.dev/v1/mcp/manifest?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toolschema-forge-mcp-manifest-generator-643199b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tHXTfIwYdmKyS_m5lQQ1z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability toolschema-forge-mcp-manifest-generator-643199b8 -d '<json body>'
```

Example prompt: Take my OpenAPI 3.0 spec and convert it to an MCP manifest — lint it for OpenAI strict mode and Anthropic compatibility, and generate a TypeScript server stub I can use right away.

## When to prefer this

Choose this endpoint when you need a deterministic, paid-per-call conversion of OpenAPI specs or raw tool definitions into MCP manifests with cross-provider linting (OpenAI incl. strict mode, Anthropic, Gemini, MCP). It is especially valuable when you need auto-fixing of schema issues, HTTP binding generation, and a ready-to-run TypeScript MCP server stub in a single call. Prefer it over manual schema authoring or open-source converters when correctness guarantees and multi-provider compatibility matter.

## Known failure modes

- Invalid or malformed OpenAPI document returns schema validation errors
- Neither 'tools' nor 'openapi' provided in body causes a 400-equivalent error
- Tools array exceeds 100-item limit causing rejection
- x402 payment not included or insufficient USDC causes 402 Payment Required response
- Unsupported Swagger/OpenAPI version may result in partial conversion or errors
- Network timeout on Cloudflare Workers edge if input payload is very large

## How this service works

Deterministic LLM tool-schema conversion, linting and MCP manifest generation for OpenAI (incl. strict mode), Anthropic, Gemini and MCP, paid per call in USDC on Base via x402.

## Output

Returns a JSON object containing: a validated MCP manifest with protocolVersion and capabilities, an array of MCP-formatted tools with inputSchema and annotations, HTTP bindings mapping each tool to its underlying REST endpoint, a list of lint issues per LLM provider (openai, openai_strict, anthropic, gemini, mcp) with severity and whether they were auto-fixed, a list of skipped operations, and a ready-to-use TypeScript MCP server stub with filename and npm dependencies.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "tools": {
       "type": "array",
       "items": {
        "type": "object"
       },
       "maxItems": 100,
       "minItems": 1,
       "description": "Tool definitions in any supported format. Give this or openapi."
      },
      "server": {
       "type": "object",
       "properties": {
        "name": {
         "type": "string"
        },
        "version": {
         "type": "string"
        },
        "description": {
         "type": "string"
        }
       },
       "description": "Optional server info overrides."
      },
      "include": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Optional operationIds or 'METHOD /path' strings to include (openapi input)."
      },
      "openapi": {
       "type": "object",
       "description": "OpenAPI 3.x or Swagger 2.0 document as JSON. Give this or tools."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "server",
      "protocolVersion",
      "capabilities",
      "tools",
      "http_bindings",
      "issues",
      "skipped",
      "stub"
     ],
     "properties": {
      "stub": {
       "type": "object",
       "properties": {
        "code": {
         "type": "string"
        },
        "filename": {
         "type": "string"
        },
        "language": {
         "type": "string"
        },
        "dependencies": {
         "type": "object"
        }
       }
      },
      "tools": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "annotations": {
          "type": "object"
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "stub": {
   "code": "import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { ListToolsRequestSchema, CallToolRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\n// ... TOOLS array, Server setup, ListTools/CallTool handlers that call the bound HTTP endpoints ...\nawait server.connect(new StdioServerTransport());",
   "filename": "server.ts",
   "language": "typescript",
   "dependencies": {
    "@modelcontextprotocol/sdk": "^1.17.0"
   }
  },
  "tools": [
   {
    "name": "getPet",
    "title": "Get Pet",
    "annotations": {
     "readOnlyHint": true,
     "openWorldHint": true,
     "idempotentHint": true,
     "destructiveHint": false
    },
    "description": "Get a pet by id",
    "inputSchema": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string"
      }
     }
    }
   }
  ],
  "issues": [],
  "server": {
   "name": "pets",
   "version": "1.0.0",
   "description": ""
  },
  "skipped": [],
  "capabilities": {
   "tools": {
    "listChanged": false
   }
  },
  "http_bindings": [
   {
    "path": "/pets/{id}",
    "tool": "getPet",
    "method": "GET",
    "baseUrl": "https://api.example.com"
   }
  ],
  "protocolVersion": "2025-06-18"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/toolschema-forge-mcp-manifest-generator-643199b8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from toolschema-forge.toolschemaforge.workers.dev](https://www.zero.xyz/host/toolschema-forge.toolschemaforge.workers.dev/llms.txt)