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
macOS (Homebrew):
brew install mmadfox/tap/swag2mcpmacOS / Linux (one-liner):
curl -fsSL https://swag2mcp.io/install.sh | bashWindows (Scoop):
scoop bucket add mmadfox https://github.com/mmadfox/scoop-bucket
scoop install mmadfox/swag2mcpAll platforms (go install):
go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latestAll platforms (Docker):
docker pull ghcr.io/mmadfox/swag2mcp:latest
docker run --rm -i -v ~/.swag2mcp:/home/nonroot/.swag2mcp ghcr.io/mmadfox/swag2mcp:latest mcpFor detailed installation instructions, see Installation.