Getting started

One dependency: Docker. Everything else - the database, the login, the generated tools - is ready as soon as the container starts.

1. Run Toolize

Toolize requires an admin password to be set explicitly - it ships with no default credential, and refuses to start without one.

terminal

docker pull ghcr.io/kouskous/toolize:latest
docker run -p 8080:8080 -v toolize-data:/data \
  -e TOOLIZE_ADMIN_PASSWORD=change-me \
  ghcr.io/kouskous/toolize:latest

This is enough to try Toolize immediately: it stores everything in an embedded database, no external database to stand up. See Docker & deployment for connecting a real PostgreSQL/MySQL/Oracle database in production.

2. Open the dashboard

url

http://localhost:8080

Log in with the admin username (admin by default, or whatever TOOLIZE_ADMIN_USERNAME was set to) and the password from step 1.

3. Import an OpenAPI spec

Paste an OpenAPI/Swagger URL, or upload a YAML/JSON file directly. Toolize parses every endpoint, then lets you choose exactly which ones become MCP tools - see OpenAPI import for the full details.

4. Connect an MCP client

The generated tools are immediately available, no restart required:

url

http://localhost:8080/mcp

Point Claude Desktop, Cursor, or any MCP client that speaks the Streamable HTTP JSON-RPC 2.0 transport at that URL.

Docker & deployment →