@rekl0w/mcp-openapi-discovery v0.2.0 brings a new server-side endpoint retrieval flow and safer OpenAPI reference handling.

Highlights

• Added search_endpoints tool for server-side endpoint search
• Added stable in-memory specId returned by detect_openapi
• Added bundle-based external $ref support for referenced schemas
• Improved endpoint retrieval using weighted scoring over:
  • method
  • path
  • operationId
  • summary / description
  • tags
  • parameter names
  • request body field names
  • response body field names
• Updated tests and documentation for the new search flow

What changed

New: specId flow

detect_openapi now returns a specId that can be reused by later tools.
This allows the server to keep the parsed spec in memory and return only relevant endpoint matches instead of exposing the full spec surface repeatedly.

New: search_endpoints

A new MCP tool, search_endpoints, can search cached endpoints for a detected spec using server-side weighted scoring.

Example queries:

• create user email
• refresh bearer token
• order status update

Improved: external $ref support

OpenAPI parsing now bundles external references before analysis, improving support for split schema files and remote referenced components.

This is especially useful for specs that keep schemas outside the root document.

Validation

Verified in this release:

• TypeScript build passes
• Test suite passes: 9/9
• npm package published successfully as:
  • @rekl0w/mcp-openapi-discovery@0.2.0

Install / update

npm i @rekl0w/mcp-openapi-discovery@latest

Notes

This release focuses on retrieval quality and better spec compatibility without requiring embeddings or client-side semantic indexing.