Enables the analysis and exploration of Swagger/OpenAPI specifications, including examining API endpoints, schemas, and response formats
Swagger Explorer MCP
A Management Control Plane (MCP) server for exploring and analyzing Swagger/OpenAPI specifications through Claude.
Quick Start
Install and run globally using npx:
Or install with environment variables:
Installation for Claude Desktop
Open Claude Desktop
Click on Settings (gear icon)
Select "Tools & Integrations"
Click "Add MCP Server"
Enter the following:
Name: Swagger Explorer Command: npx -y @johnneerdael/swagger-mcp Arguments: --swagger-url=$SWAGGER_URLClick "Install"
Usage with Claude
Here are some example interactions with Claude:
Basic Swagger Exploration
Analyzing Specific Endpoints
Schema Analysis
Features
Authentication Support
Bearer token authentication
Configurable through environment variables
Custom Response Formatting
Minimal format: Removes null/empty values
Detailed format: Includes metadata and timestamps
Raw format: Unmodified response
Schema Analysis
Detailed property exploration
Response schema analysis
Schema relationships
API Exploration
Path listing
Method filtering
Response format analysis
Configuration
Environment Variables:
BASE_URL
: Base path for the API (default: '')AUTH_TOKEN
: Bearer token for authenticationPORT
: Server port (default: 3000)SWAGGER_URL
: Default Swagger documentation URL
API Endpoints
Explore API
Get Schema Details
Get Response Schemas
Response Formats
Minimal Format
Detailed Format
Common Use Cases
API Documentation Review
Human: Can you summarize all the available endpoints and their purposes?Schema Validation
Human: What fields are required for creating a new pet?Response Analysis
Human: What are the possible error responses for the login endpoint?Integration Planning
Human: How should I structure my request to create a new order?
Troubleshooting
Connection Issues
Ensure the Swagger URL is accessible
Check if authentication token is correct
Verify port is not in use
Authorization Errors
Verify AUTH_TOKEN is set correctly
Ensure bearer token is included in requests
Schema Not Found
Check if schema name is exact match
Verify Swagger spec is loaded correctly
Security Notes
The MCP requires authentication if AUTH_TOKEN is set
All requests are logged for debugging
Sensitive information is not cached
Rate limiting is applied to prevent abuse
Development
To contribute or modify:
Clone the repository
Install dependencies:
npm installBuild:
npm run buildRun locally:
npm start
License
MIT License - See LICENSE file for details
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Management Control Plane server that allows users to explore and analyze Swagger/OpenAPI specifications, providing features such as endpoint exploration, schema analysis, and customizable response formatting, with support for authentication and integration with tools like Claude.
- Quick Start
- Installation for Claude Desktop
- Usage with Claude
- Features
- Configuration
- API Endpoints
- Response Formats
- Common Use Cases
- Troubleshooting
- Security Notes
- Development
- License
Related Resources
Related MCP Servers
- -securityAlicense-qualityA server that enables interaction with any API that has a Swagger/OpenAPI specification through Model Context Protocol (MCP), automatically generating tools from API endpoints and supporting multiple authentication methods.Last updated -35104Apache 2.0
- AsecurityAlicenseAqualityAn MCP server that connects to a Swagger specification and helps an AI to build all the required models to generate a MCP server for that service.Last updated -53581MIT License
- AsecurityAlicenseAqualityMCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.Last updated -2252MIT License
- AsecurityAlicenseAqualityA tool that creates MCP (Model Context Protocol) servers from OpenAPI/Swagger specifications, enabling AI assistants to interact with your APIs.Last updated -32025MIT License