Swagger/OpenAPI MCP Server

A Model Context Protocol (MCP) server that allows LLMs to explore and interact with Swagger/OpenAPI specifications. This server provides tools and resources for loading API specifications, browsing endpoints, and getting detailed information about API operations.

Installation

Clone or create the project directory
Install dependencies:

npm install

Build the TypeScript code:

npm run build

Usage

Available Tools

`load_api`

Load an OpenAPI/Swagger specification into the server.

Parameters:

apiId (string): Unique identifier for this API
source (string): URL or file path to the OpenAPI/Swagger specification

Example:

{
  "name": "load_api",
  "arguments": {
    "apiId": "petstore",
    "source": "https://petstore.swagger.io/v2/swagger.json"
  }
}

`get_endpoint_details`

Get detailed information about a specific API endpoint.

Parameters:

apiId (string): ID of the loaded API
method (string): HTTP method (GET, POST, etc.)
path (string): API endpoint path
natural (boolean, optional): If true, returns a human-readable summary

Example:

{
  "name": "get_endpoint_details",
  "arguments": {
    "apiId": "petstore",
    "method": "GET",
    "path": "/pet/{petId}",
    "natural": true
  }
}

`list_apis`

List all currently loaded API specifications.

Parameters: None

`search_endpoints`

Search for endpoints matching a specific pattern.

Parameters:

apiId (string): ID of the loaded API
pattern (string): Search pattern for endpoint paths or descriptions

Example:

{
  "name": "search_endpoints",
  "arguments": {
    "apiId": "petstore",
    "pattern": "pet"
  }
}

Available Resources

`swagger://{apiId}/load`

Get overview information about a loaded API specification.

`swagger://{apiId}/endpoints`

Get a list of all available endpoints for an API.

`swagger://{apiId}/endpoint/{method}/{path}`

Get detailed information about a specific endpoint.

Configuration with Claude Desktop

To use this server with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "swagger-explorer": {
      "command": "node",
      "args": ["/path/to/your/swagger-mcp-server/build/index.js"]
    }
  }
}

Replace /path/to/your/swagger-mcp-server with the actual path to your project directory.

License

MIT License

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

A Model Context Protocol server that enables LLMs to explore and interact with API specifications by providing tools for loading, browsing, and getting detailed information about API endpoints.

Related MCP Servers

MCP Salesforce Connector
smn2gnt
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with Salesforce data through SOQL queries, SOSL searches, and various API operations including record management.
Last updated -
10
124
Python
MIT License
MCP Web Tools Server
surya-madhav
-
security
A
license
-
quality
A Model Context Protocol server that allows LLMs to interact with web content through standardized tools, currently supporting web scraping functionality.
Last updated -
Python
MIT License
mcp-graphql
launchthatbrand
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
Last updated -
429
1
MIT License
OpenAPI MCP Server
rahgadda
-
security
A
license
-
quality
A Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.
Last updated -
6
Python
Apache 2.0

View all related MCP servers

Swagger/OpenAPI MCP Server