Swagger MCP Bridge
If you're running a SpringDoc-powered Spring Boot API and want LLMs to call it directly, this starter autowires your OpenAPI spec into MCP tools with zero boilerplate. Beyond simple tool wrappers, it adds a gateway layer with meta-tools for API discovery, preflight validation, and multi-step workflow planning. You get JSONPath response shaping, execution guardrails for dangerous operations, and structured error codes. Works on Java 17+ with optional virtual threads on 21+. The example exposes a basic greeting controller, but the real use case is wrapping existing REST APIs so Claude can inspect capabilities, validate calls, and orchestrate sequences without hardcoding tool names.
- tools
- 8
- transport
- HTTP
- last updated
- May 3, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
api_meta_get_api_capabilitiesReturns API catalog stats, available gateway tools, orchestration features, safety policy, and response controls.
Returns API catalog stats, available gateway tools, orchestration features, safety policy, and response controls.
No parameter schema in public metadata yet.
api_meta_list_api_groupsSummarizes the exposed API catalog by OpenAPI tag/group.
Summarizes the exposed API catalog by OpenAPI tag/group.
No parameter schema in public metadata yet.
api_meta_discover_api_toolsFinds relevant operations for a natural-language request.
Finds relevant operations for a natural-language request.
No parameter schema in public metadata yet.
api_meta_describe_api_toolReturns the selected tool's method/path, parameters, required arguments, request body schema, risk flags, and full MCP input schema.
Returns the selected tool's method/path, parameters, required arguments, request body schema, risk flags, and full MCP input schema.
No parameter schema in public metadata yet.
api_meta_validate_api_callValidates one generated API tool call without dispatching HTTP, including required arguments, risky-operation confirmation, and dispatch preview.
Validates one generated API tool call without dispatching HTTP, including required arguments, risky-operation confirmation, and dispatch preview.
No parameter schema in public metadata yet.
api_meta_plan_api_workflowTurns a workflow goal into a deterministic candidate step plan with contracts and risk flags.
Turns a workflow goal into a deterministic candidate step plan with contracts and risk flags.
No parameter schema in public metadata yet.
api_meta_invoke_api_workflowDry-runs or executes multiple generated API tools sequentially.
Dry-runs or executes multiple generated API tools sequentially.
No parameter schema in public metadata yet.
api_meta_invoke_api_by_intentSelects and invokes the best matching operation when the client already has enough arguments.
Selects and invokes the best matching operation when the client already has enough arguments.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Swagger MCP Bridge
Turn any SpringDoc-powered Spring Boot API into a production-ready MCP gateway.
Swagger MCP Bridge discovers your OpenAPI operations, publishes them as safe MCP tools, and adds a smart gateway layer for API discovery, validation, response shaping, and multi-step workflow orchestration.
Naming and Coordinates
This repository intentionally separates the public surfaces so each one reads naturally in its own ecosystem:
Details
- Repository
- github.com/neo1228/spring-boot-starter-swagger-mcp
- Package
ghcr.io/neo1228/swagger-mcp-bridge-example:0.1.0- Transport
- HTTP
- Registry
- MCP registry, active