Toolize

OpenAPI import

What actually happens between pasting a spec and having callable MCP tools.

Bringing your spec in

Paste an OpenAPI/Swagger URL, or upload a YAML/JSON file directly. Toolize parses every endpoint, schema, parameter, and declared security scheme.

Choosing which endpoints become tools

Not every endpoint should be exposed to an AI agent. Right after import, pick exactly which ones to turn into MCP tools - and change that selection later from the project's page, any time, without re-importing anything.

How operationId becomes a tool name

Each generated tool's name comes from the operation's operationId. If the spec doesn't declare one for a given endpoint, Toolize generates one from its method and path.

Real-world specs don't always keep operationId unique across every endpoint, even though the OpenAPI specification says they should. Toolize detects any collision and renames every duplicate after the first occurrence (for example, a repeated list becomes list_2) - deterministically, so re-parsing the same spec always produces the same names. This keeps every endpoint independently selectable and every tool independently addressable, even when the source spec itself doesn't guarantee uniqueness.

Writing tool descriptions your agent understands

Generated tools start from the spec's own summary and description fields - but specs are written for humans, not agents, and plenty say nothing useful at all. From any tool's detail page, override its description or any parameter's hint: when to use it, what a parameter really means, when not to call it. Changes apply immediately on /mcp, with no re-import required.

The description Toolize actually uses, in order of preference:

  1. Your custom description, if you've set one.
  2. The spec's own description field for that operation.
  3. The spec's summary field.

Usage analytics

Every tool call - whether from a real MCP client or the "Execute" button in the UI - is tracked: total calls, error rate, average latency, and the most recent calls with their status and timing. Available per tool and rolled up per project.

← Authentication