amrsa1/swagger-mcp

3.3

If you are the rightful owner of swagger-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Swagger MCP Server is a tool designed to facilitate the exploration and testing of APIs using Swagger/OpenAPI documentation, with support for multiple IDEs and flexible authentication options.

Tools

Functions exposed to the LLM to take actions

fetch_swagger_info

Fetches and parses Swagger/OpenAPI documentation from a given URL to discover available API endpoints.

list_endpoints

Lists all available API endpoints after fetching Swagger documentation, showing methods, paths, and summaries.

get_endpoint_details

Gets detailed information about a specific API endpoint including parameters, request/response schemas, and examples.

execute_api_request

Executes an API request to a specific endpoint with authentication, parameters, headers, and body handling.

validate_api_response

Validates an API response against the schema definitions from Swagger documentation to ensure compliance.

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources

Author

amrsa1

Claim Ownership

Verify you have write access to the repository

Version

v1.1.0

Repository

https://github.com/amrsa1/swagger-mcp

Homepage

https://www.npmjs.com/package/swagger-mcp

GitHub Stars

License

MIT License

Last publish date

2025-06-30

Last update date

2025-09-18

Server configs

in vs code

{
  "swagger-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "swagger-mcp@latest"
    ],
    "env": {
      "API_BASE_URL": "https://api.example.com",
      "API_DOCS_URL": "https://api.example.com/swagger.json",
      "API_KEY": "your-api-key-here"
    }
  }
}

in cursor

{
  "swagger-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "swagger-mcp@latest"
    ],
    "env": {
      "API_BASE_URL": "https://api.example.com",
      "API_DOCS_URL": "https://api.example.com/swagger.json",
      "API_KEY": "your-api-key-here"
    }
  }
}

in windsurf

{
  "swagger-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "swagger-mcp@latest"
    ],
    "env": {
      "API_BASE_URL": "https://api.example.com",
      "API_DOCS_URL": "https://api.example.com/swagger.json",
      "API_KEY": "your-api-key-here"
    }
  }
}