list_categoriesLABSCO SUMMARY
Big specs become navigable rather than unreadable.
A serious OpenAPI document is far too large to hand a model in one piece, and truncating it loses exactly the endpoint you needed. Walking it in layers keeps the whole API reachable at a fraction of the context.
What it is
A navigator for one OpenAPI specification. It loads the spec from a URL or a file and lets a model walk it in layers — categories, then endpoints, then the detail of a single operation or schema.
What you get
- Top-level information about the loaded specification
- The categories the API is organised into
- The endpoints listed rather than dumped
- One endpoint in full — parameters, request and response
- One schema in full
- Remote specs cached locally, so repeat exploration does not refetch
Requirements
Docker, or a downloaded binary for Linux amd64 or arm64. OPENAPI_SPEC_URL is required and takes a URL or a file path; the cache location is optional and defaults to ~/.openapi-mcp-cache. Stdio, HTTP and interactive CLI modes ship as separate builds.
Setup effort
One command — docker pull ghcr.io/sagenkoder/go-openapi-exploration-mcp-server:latest
USE CASES
01
Finding the right endpoint in an unfamiliar API
Start from the categories and narrow, instead of scrolling the whole document.
02
Writing a call correctly the first time
Read the one endpoint in full — parameters, body, responses — before generating any client code.
03
Understanding what a response actually contains
Open the schema behind it rather than inferring the shape from an example.
04
Checking which API and version you are pointed at
Read the spec's own top-level information before trusting anything built on it.
5 tools
Listed in project docs. Your client may show a different list.
list_endpointsshow_endpointget_spec_infoshow_schemaBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
docker on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
docker pull ghcr.io/sagenkoder/go-openapi-exploration-mcp-server:latestMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"openapi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"OPENAPI_SPEC_URL=<YOUR_SERVER_URL>/openapi.json",
"ghcr.io/sagenkoder/go-openapi-exploration-mcp-server:latest"
]
}
}
}
