About Swagger MCP Tool
Swagger MCP Tool is an MCP server published by sdlbp in the Documentation category: swagger MCP tool that provides Swagger/OpenAPI document query capabilities for AI assistants and MCP clients.
The repository has 3 stars and 0 forks, with the last commit 9 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
claude mcp add swagger-mcp-tool -- npx -y swagger-mcp-toolnpx -y swagger-mcp-toolThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
get_api_detailGet full operation detail
Parameters not published.
get_schemaGet schema by `$ref` or name
Parameters not published.
list_api_groupsList all API groups (tags)
Parameters not published.
search_apisSearch APIs by tag or keyword
Parameters not published.
Ask AI
Ask AI about Swagger MCP Tool
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 12 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
Releases
README
swagger-mcp-tool
What is swagger-mcp-tool
An MCP (Model Context Protocol) server that loads Swagger/OpenAPI documents and exposes query tools for AI assistants and MCP clients.
Features
- Generate API-related code directly through an agent using Swagger docs.
- Generate response types and interface definitions for TypeScript projects.
Installation
Prerequisites
- Node.js >= 18
- npm or npx (for running the CLI)
- Bun >= 1.0.0 (optional, for development/build)
Install
npm install -g swagger-mcp-tool
Usage
Add one or more server entries to your MCP client config (example for Cursor: ~/.cursor/mcp.json). Use a separate server name per Swagger/OpenAPI document to support multiple projects in parallel.
{
"mcpServers": {
"swagger-petstore": {
"command": "npx",
"args": ["-y", "swagger-mcp-tool", "https://example.com/petstore.json"]
},
"swagger-orders": {
"command": "npx",
"args": ["-y", "swagger-mcp-tool", "./openapi/orders.yaml"]
}
}
}
Chat panel examples
After the server is configured, describe what you want to add in the chat panel. Start with "View the Swagger doc" to help the agent trigger this tool, for example:
"View the Swagger doc and complete the refund API for the order domain."
API
| Tool | Description | Parameters | Output |
|---|---|---|---|
list_api_groups |
List all API groups (tags) | None | JSON array of tag objects |
search_apis |
Search APIs by tag or keyword | tag (optional), keyword (optional) |
JSON array of API summaries |
get_api_detail |
Get full operation detail | path, method |
JSON operation object |
get_schema |
Get schema by $ref or name |
ref |
JSON schema object |
License
This project is licensed under the MIT License - see the LICENSE file for details.
README fetched from the repository 12 days ago. The original is authoritative.