
FastMCP Docs
Writes and revises pages for the FastMCP docs site with its checks.
Install
npx skills add PrefectHQ/fastmcp --skill docs -g -a claude-code -y- Repository
- PrefectHQ/fastmcp28.3k
- Category
- Documents
- Updated
- 3d ago
- License
- Apache-2.0
- Context cost
- Lightabout 966 tokens
- Runs scripts
- No, instructions only
What it does
Write or revise a page under docs/ for gofastmcp.com. Use when adding a feature's documentation, fixing a docs issue, reworking a page, or auditing pages for accessibility and consistency. Covers the page shape, the voice, the checks that run in CI, and how a merged page reaches the live site.
FastMCP docs
The docs are a Mintlify site built from docs/. A page exists only when docs/docs.json lists it, and a feature exists only when a page documents it. docs/python-sdk/** is generated from docstrings by a bot; edit the docstring, not the page.
Procedure
- Find the owning page before creating one.
rg -l "<feature>" docs --glob '!docs/python-sdk/**' --glob '!docs/v2/**' --glob '!docs/v3/**'. Extend it when the feature belongs to that page's subject; add a page when it has its own. - Read two neighboring pages in the same
docs.jsongroup and match their section order and heading depth. - Write the page with the template below. Explain why the feature exists before showing how, and keep the first code block small enough to read without scrolling.
- Make every code block runnable: imports present, names defined, one idea per block. Pull intermediate values into named variables instead of nesting calls.
- Run the checks in Verify and fix what they report.
- When the change is ready to ship, open a PR against
main. Merged is not live: the site servespublished-docs. A stable release frommainopens aPublish FastMCP v<version> docsPR againstpublished-docsthat a maintainer merges; for a docs-only change between releases, follow "Publishing docs by hand" in.agents/skills/release/SKILL.md. Either way, theDeploy docsrun's verdict is what says the site changed.
Template
---
title: Feature Name
sidebarTitle: Feature
description: One sentence a search result can show.
icon: some-fontawesome-icon
---
import { VersionBadge } from '/snippets/version-badge.mdx'
<VersionBadge version="<version that introduces the feature>" />
One paragraph on the problem this solves and when to reach for it.
## Basic usage
Explain what the example does, then show it.
```python
from fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.tool
def greet(name: str) -> str:
return f"Hello, {name}!"
```
## Configuration


