![swag2mcp](docs/logo.svg)

**swag2mcp** is a local-first bridge between OpenAPI/Swagger/Postman API specifications and LLM agents via the Model Context Protocol (MCP). Not every API speaks MCP — private endpoints, internal services, legacy systems, and third-party APIs rarely do. swag2mcp wraps any REST API in an MCP interface, giving LLM agents instant access to your entire API surface without modifying a single line of server code. Through live API calls, the LLM gains real-world knowledge to make informed decisions, automate workflows, and act on your data — not just guess. - **16 MCP tools** for discovering, inspecting, and invoking APIs - **Interactive TUI explorer** with full-text search - **Zero integration code** — just point to your specs and go --- - Installation - Quickstart - Documentation ---

🎬 Live session

--- ## Quick Start ### Install **macOS / Linux (one-liner):** ```bash curl -fsSL https://swag2mcp.io/install.sh | bash ``` **Windows (Scoop):** ```powershell scoop bucket add mmadfox https://github.com/mmadfox/scoop-bucket scoop install mmadfox/swag2mcp ``` **All platforms (go install):** ```bash go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest ``` **All platforms (Docker):** ```bash docker pull ghcr.io/mmadfox/swag2mcp:latest docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcp ``` > For detailed installation instructions, see [Installation](https://mmadfox.github.io/swag2mcp/getting-started/installation).

Command Palette

Tagged “swagger-mcp”

Servers

swag2mcp