swag2mcp

🚧 WORK IN PROGRESS — release coming soon!

Bridges OpenAPI/Swagger/Postman API specifications with LLM agents via the Model Context Protocol (MCP).

Your API speaks LLM

One line of config turns any OpenAPI/Swagger/Postman file into an MCP server. LLM agents discover, inspect, and invoke your APIs — zero integration code.

Stop writing wrappers

Every time you connect a new API to an LLM, you write the same boilerplate: spec parsing, authentication, error handling, rate limiting. swag2mcp does it for you — 19 ready-made MCP tools.

Who needs this

Role	Why
AI Agent Developer	Connect any API in 2 minutes, not 2 days
MCP Engineer	No handler code — just point to a spec
Architect	Single API integration layer for all LLMs in your company
Data Analyst	Access APIs via natural language, no coding
DevOps / SRE	Monitoring and automation through LLM without extra services
Integrator	9 auth methods out of the box — Basic to OAuth2 to HMAC
QA Engineer	Mock server for isolated testing without real APIs
Product Manager	Rapid AI feature prototypes without backend work
and many others

---

License

Licensed under the GNU Affero General Public License v3.0 (AGPL v3).

See LICENSE for the full license text.

SPDX-License-Identifier: AGPL-3.0-only

Quick Start

go install github.com/mmadfox/swag2mcp/cmd/swag2mcp@latest
swag2mcp init
swag2mcp import https://raw.githubusercontent.com/mmadfox/swag2mcp/main/specs/dadjoke.yaml dadjoke
swag2mcp mcp

Integrations

OpenCode · Cursor · Claude Desktop · VS Code · Crush