Mocapi Guides

How to use mocapi as a library consumer. If you're building an MCP server, start here.

Getting started

• Writing Tools
• Writing Prompts
• Writing Resources
• Configuration Reference

Interactivity

• Interactive Tools — progress, MRTR elicitation
• Externalizing Metadata
• MCP Apps — declare a ui:// resource, link it to a tool, and hand off to the official in-iframe JS SDK
• MCP Tasks — poll long-running tools with @McpTask, plus deployment topology and custom TaskStore guidance

Extending mocapi

• Extending mocapi — start here: the seam taxonomy, one worked example per seam, the dispatch-interceptor contract
• Customizers
• Custom Parameter Resolvers
• Guards
• Bean Validation

Security & Authorization

• Securing your MCP server — start here: the pre-production hardening checklist
• OAuth2 Resource Server

Operations

• Observability Overview — Logging, OTel, Audit, Actuator
• Logging / MDC Correlation
• OpenTelemetry
• Audit
• /actuator/mcp Endpoint
• Throughput & Saturation Testing — find the request-throughput ceiling (k6, two-box)
• Performance Benchmarking
• Performance History