Introduction
Introduction
What is jooby-mcp?
jooby-mcp integrates the Model Context Protocol (MCP) Java SDK with the Jooby framework. It lets you expose tools, prompts, and resources to MCP clients using declarative, annotation-based APIs with discovery at build time via an annotation processor, so no runtime reflection is required.
Prerequisites
- A Jooby application (3.x or 4.x).
- Basic familiarity with MCP concepts (tools, prompts, resources) is helpful but not required.
Version compatibility
| Jooby | jooby-mcp |
|---|---|
| 3.x | 1.x |
| 4.x | 2.x |
Features
Transport
- SSE, Streamable HTTP, and Stateless Streamable HTTP
- Multiple MCP servers in one application
MCP capabilities
- Tools, Prompts, Resources
- Resource templates with URI patterns and completions
- Prompt completions and resource-template completions
Quality & tooling
- Required argument validation and build-time checks for method signatures and return types
- Elicitation, Sampling, and Progress via the exchange object
- Optional MCP Inspector module for local testing
In this documentation
| Section | Description |
|---|---|
| Quick Start | Add the dependency, configure the server, and run your first MCP endpoint. |
| Tools, Prompts, Resources | Core MCP capabilities and annotations. |
| Exchange object | Elicitation, Sampling, and Progress. |
| Multiple servers, Customizing server | Run several servers and change the default key or package. |
| MCP Inspector | Local testing in the browser. |
| Supported return types | Reference for tools, prompts, and resources. |
Next: Quick Start — add the dependency and run your first MCP server.