Practical overview
When it fits
Use FastMCP when implementing an MCP server in TypeScript and its documented protocol revision and transport options fit the project. Check the protocol boundary before adopting it, especially for clients or deployments requiring the current stateless MCP specification.
Who it is for
- TypeScript developers building MCP servers for client sessions.
- Teams exposing tools, resources or prompts to MCP clients.
- Developers adapting an existing OpenAPI service for access through MCP.
Documented uses
- Define MCP tools with descriptions, validated parameters and execution logic.
- Expose resources and prompts from a server.
- Start a basic server over stdio or configure remote HTTP streaming.
- Convert an OpenAPI service into an MCP interface.
- Use documented CLI commands to test or inspect a server example during development.
Requirements & limits
The framework is installed as an npm package. The public GitHub repository identifies the project as MIT-licensed.
- FastMCP is server-building infrastructure; it is not itself an MCP client or hosted application.
- The README says it implements handshake-based MCP revisions through 2025-11-25 and does not support the stateless 2026-07-28 specification.
- The documented quickstart uses TypeScript, npm and Zod or another Standard Schema-compatible validation library.
- The README presents the framework as a higher-level layer over the official SDK; it recommends the SDK when maximum control or specific architectural requirements are needed.
- The README documents stdio and HTTP streaming transport options, as well as OpenAPI conversion.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Create and start a basic stdio MCP server
Define a simple addition tool and start its server over stdio, following the documented quickstart.
Before you start
- Node.js project using TypeScript
- The fastmcp package installed with npm
- Zod, or another validation library supporting Standard Schema
Steps
Install the framework with the command below.
npm install fastmcpImport
FastMCPand Zod, then create a server with a name and version.Add a tool with a name, description, numeric parameters and an execution function that returns the result.
Start the server with
transportType: "stdio".
Expected outcome
A basic MCP server exposing an addition tool over stdio.
Guide limitations
- This recipe follows the README’s legacy, handshake-based MCP implementation; it does not target the stated current stateless specification.
- The quickstart shows a simple example and does not document integration with a particular MCP client.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- punkpeye/fastmcp · Official homepage title · retained in its source language
Related options
ViteMCP — Named in the FastMCP README as a framework targeting the current stateless MCP specification.
Official MCP SDK — FastMCP is built on this SDK and adds higher-level server setup and handling; the README points to the SDK for projects needing maximum control or specific architectural requiremen

