OpenAPI Slice
About
An MCP (Model Context Protocol) server that helps you work with large OpenAPI specifications by extracting only the relevant portions for specific endpoints. This is particularly useful when working with LLMs that have context limitations - instead of loading an entire large Open
Details
- Author
- vvarp
- Downloads
- 339
- Categories
- Other, API
Jump to
- Endpoint-specific extraction with automatic dependency resolution
- Supports local YAML/JSON files and remote URLs (HTTP/HTTPS)
- Output in YAML or JSON format
- Discovery tool to list all endpoints in a loaded spec
- Recursively includes all referenced components (schemas, parameters, etc.)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenAPI SliceCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server with uvx openapi-slice-mcp. It communicates via STDIO and provides tools to load specs (from file or URL), list endpoints, extract endpoint slices, and check server status.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openapi slice": {
"openapi-slice-mcp": {
"command": "uvx",
"args": [
"openapi-slice-mcp"
]
}
}
}
}McpServers
{
"openapi-slice-mcp": {
"command": "uvx",
"args": [
"openapi-slice-mcp"
]
}
}OpenAPI Slice MCP Server
An MCP (Model Context Protocol) server that helps you work with large OpenAPI specifications by extracting only the relevant portions for specific endpoints. This is particularly useful when working with LLMs that have context limitations - instead of loading an entire large OpenAPI spec, you can extract just the parts you need for a specific endpoint.
Features
- Endpoint-specific extraction: Get minimal OpenAPI specs containing only the requested endpoint and its dependencies
- Automatic dependency resolution: Recursively finds and includes all referenced components (schemas, parameters, etc.)
- Multiple formats: Output in YAML or JSON format
- File support: Load OpenAPI specs from local YAML or JSON files
- Remote support: Fetch OpenAPI specs directly from URLs (HTTP/HTTPS)
- Discovery tools: List all available endpoints in a loaded specification
Tools
The server provides the following MCP tools:
- load_openapi_spec(file_path: str) - Load an OpenAPI specification from a local YAML or JSON file
- load_openapi_spec_from_url(url: str, timeout: int = 30) - Load an OpenAPI specification from a remote URL
- list_endpoints() - List all available endpoints in the currently loaded specification
- extract_endpoint_slice(path: str, method: str, output_format: str = "yaml") - Extract a minimal spec slice for a specific endpoint
- get_server_status() - Get the current status of the server
Usage
Running the Server
uvx openapi-slice-mcp
The server runs using the STDIO transport and can be integrated with any MCP client.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
