swag2mcp
swag2mcp is an MCP server that bridges OpenAPI/Swagger/Postman API specifications to LLM agents, enabling discovery, inspection, invocation, and analysis of REST APIs without modifying server code.
API Discovery & Navigation — List and retrieve specs, collections, tags, and endpoints. Use search to find endpoints by natural language or structured queries.
Inspect Endpoints — Retrieve full OpenAPI operation details (parameters, request body, responses) via inspect before invoking.
Invoke APIs — Execute real HTTP calls with invoke, automatic authentication, and handling of large responses (saved to disk).
Large Response Processing — Explore saved responses using response_outline, response_slice, response_filter, and response_compress to navigate, filter, sample, and compress data.
System Info — Check runtime configuration, active specs, rate limits, mock mode via info.
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/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.
Maintenance
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAutomatically converts Swagger/OpenAPI specifications into MCP servers, enabling AI agents to interact with any REST API through natural language by exposing endpoints as AI-friendly tools.3
- AlicenseNot gradedqualityCmaintenanceTurns any OpenAPI specification into a fully working MCP server with a single command, enabling AI agents to call APIs without writing any glue code.13MIT
- AlicenseNot gradedqualityBmaintenanceConverts any OpenAPI specification into an MCP server, allowing AI assistants to interact with REST APIs through natural language.91MIT
- AlicenseNot gradedqualityBmaintenanceEnables LLMs to interact with any REST API that has an OpenAPI specification by providing a lightweight MCP server that translates between natural language and API calls.MIT
Related MCP Connectors
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
MCP server for AI access to Swagger by SmartBear.
Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mmadfox/swag2mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server