Learn

Hands-on examples for building MCP systems with finemcp. Each tutorial is a self-contained runnable example from the examples repository.

Server

Demonstrates how to create and configure an MCP server using finemcp.NewServer.

Demonstrates all the ways to create and configure tools in FineMCP.

Demonstrates how a tool can stream multiple content fragments back to the client before returning the final result.

Demonstrates how to expose data as MCP resources that clients can read and subscribe to.

Demonstrates the MCP prompt system for reusable prompt templates with arguments and auto-completion.

Demonstrates the MCP sampling API for **server-initiated LLM requests** — where the server asks the *client* to perform LLM inference.

Demonstrates registering **root URIs** that define the content boundaries visible to the server.

Demonstrates the MCP elicitation API for **server-initiated user prompts** — where the server asks the client to collect input from the user.

Demonstrates how tools report **incremental progress** to the client during long-running operations.

Demonstrates the MCP server logging API for sending **structured log messages** to the client.

Demonstrates the MCP auto-completion system for both **prompts** and **resource templates**.

Demonstrates the five transport mechanisms available in finemcp for client-server communication.

Demonstrates 16 middleware types that wrap tool handlers with cross-cutting concerns.

Demonstrates in-process MCP server testing using the mcptest package — no HTTP, no network.

Demonstrates all MCP content types: **text**, **image**, and **embedded resource**.

Demonstrates **Pipeline** and **Parallel** composition patterns for combining multiple tool handlers.

Demonstrates how to **embed an MCP server** into an existing HTTP application alongside regular HTTP routes.

Real-world style MCP servers you can connect to Claude Desktop or any MCP client.