# Tachyon MCP

> Tachyon MCP - production Model Context Protocol server runtime for Java and Kotlin. Netty, virtual threads, stateless by default, MCP 2025-11-25 and 2026-07-28 conformance.

Each link below serves the page as plain Markdown. All pages in one file: https://tachyonmcp.dev/llms-full.txt

## Docs

- [Documentation](https://tachyonmcp.dev/docs/index.md): Run your first Tachyon MCP server, build tools, and prepare for deployment.
- [Quickstart](https://tachyonmcp.dev/docs/quickstart.md): Build a complete Java MCP server and call its greeting tool with MCP Inspector or curl.
- [Agent Skill](https://tachyonmcp.dev/docs/agent-skill.md): Install the tachyon-mcp agent skill so Claude Code, Codex, Cursor, and other coding agents write correct Tachyon servers.

- [Spring Boot](https://tachyonmcp.dev/docs/spring-boot/index.md): Expose Spring beans as MCP tools with Tachyon's Spring Boot starter. Build a greeting server and call it with MCP Inspector or curl.
- [Spring Boot reference](https://tachyonmcp.dev/docs/spring-boot/reference.md): Configure Spring Boot integration: properties, bean discovery, customizers, Actuator, and native images.
- [MCP Testkit](https://tachyonmcp.dev/docs/testkit.md): Test Tachyon servers end to end: shaping clients, dynamic-port servers, and fluent JSON-RPC assertions.

- [MCP features](https://tachyonmcp.dev/docs/features/index.md): Add tools, resources, prompts, completions, client interactions, and long-running tasks.
- [Tools](https://tachyonmcp.dev/docs/features/tools.md): Declare MCP tools with annotations, bind typed arguments, return structured output, and use programmatic registration when needed.
- [Resources](https://tachyonmcp.dev/docs/features/resources.md): Declare fixed and templated MCP resources with annotations, return text or binary content, and notify subscribers.
- [Prompts](https://tachyonmcp.dev/docs/features/prompts.md): Declare MCP prompts with annotations, bind arguments, and return reusable messages with Java or Kotlin.
- [Completions](https://tachyonmcp.dev/docs/features/completions.md): Use annotations to suggest MCP prompt arguments and resource-template variables, including automatic enum completions.
- [Client interactions](https://tachyonmcp.dev/docs/features/client-interactions.md): Request user input from a handler and understand Tachyon's sampling compatibility boundary.

- [Running Tachyon](https://tachyonmcp.dev/docs/running/index.md): Configure, deploy, and observe a Tachyon MCP server.
- [Configuration](https://tachyonmcp.dev/docs/running/configuration.md): Configure Tachyon servers: network settings, native I/O engines, sessions, CORS, keep-alive, graceful shutdown, and more.
- [Deployment](https://tachyonmcp.dev/docs/running/deployment.md): Deploy a Tachyon server to a platform: bind address, port, public hostname and DNS-rebinding protection, browser clients, and container signal handling.
- [Observability](https://tachyonmcp.dev/docs/running/observability.md): Trace and measure Tachyon servers with OpenTelemetry: set up the listener, read the resulting span and metric, then opt in to payload capture.
- [Annotations](https://tachyonmcp.dev/docs/annotations.md): Declare tools, resources, prompts, and completions on plain Java methods — or bridge third-party annotation frameworks (mcp-java, LangChain4j, Spring AI) via the AnnotationProvider SPI.
- [JSON and JSON Schema](https://tachyonmcp.dev/docs/json.md): How Tachyon handles JSON payloads and JSON Schema validation: JsonDocument types, schema dialects, and pluggable validators.

- [Extensions](https://tachyonmcp.dev/docs/extensions/index.md): Use protocol extensions in your Tachyon server (SEP-2133): built-in extensions, client negotiation per MCP version, and negotiation policy.
- [Tasks](https://tachyonmcp.dev/docs/extensions/tasks.md): Long-running operations in Tachyon: the `tasks/*` lifecycle, enforced state machine, status notifications, and TasksExtension (SEP-2663; SEP-1686 for MCP 2025-11-25 clients).
- [Skills over MCP](https://tachyonmcp.dev/docs/extensions/skills.md): Ship an MCP Skills extension (SEP-2640) from your Tachyon server so agents can discover and install skills.
- [Write an extension](https://tachyonmcp.dev/docs/extensions/custom-extensions.md): Build your own MCP extension step by step: a custom JSON-RPC method, a call from curl, troubleshooting, and the authoring reference.

- [Kotlin](https://tachyonmcp.dev/docs/kotlin/index.md): Coroutine-first Kotlin DSL for Tachyon
- [Kotlin Serialization + JSON Schemas](https://tachyonmcp.dev/docs/kotlin/kt-schema-json.md): Generate JSON Schemas from kotlinx.serialization classes with kt-schema and wire them into Tachyon tool contracts.
- [Migrating from Kotlin SDK](https://tachyonmcp.dev/docs/kotlin/migrate-from-kotlin-sdk.md): Port a Kotlin MCP SDK server to Tachyon: type-for-type API translation, dependency swap, and the behaviour changes that don't fail to compile.
- [FAQ](https://tachyonmcp.dev/docs/faq.md): Answers to common questions about Tachyon: Java versions, frameworks, concurrency, deployment, and compatibility.