swag2mcp

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

Quick Start

Install

macOS (Homebrew):

brew install mmadfox/tap/swag2mcp

macOS / Linux (one-liner):

curl -fsSL https://swag2mcp.io/install.sh | bash

Windows (Scoop):

scoop bucket add mmadfox https://github.com/mmadfox/scoop-bucket
scoop install mmadfox/swag2mcp

All platforms (go install):

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest

All platforms (Docker):

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.