A set of writing rules for producing technical documentation with Mintlify, a service that turns documentation files into a published website. It covers wording, structure, navigation, and use of Mintlify components.

Writing guides, reference pages, tutorials, and procedures. It helps structure explanations, prerequisites, numbered steps, headings, and links to related information.

It helps keep documentation clear, consistent, and organized so readers can find and follow instructions more easily.

mintlify — Cursor rule by PrefectHQ

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add rules/prefecthq/fastmcp/mintlify

Clone the repo

git clone --depth 1 https://github.com/PrefectHQ/fastmcp

Made for: Cursor.

Per session 2,203 This file is loaded in full into every session.

When invoked 2,203 The same file — it is already loaded in full.

Security scan B 2 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.02203	$0.02203
Opus 5	$0.01102	$0.01102
Sonnet 5	$0.00441	$0.00441
Haiku 4.5	$0.00220	$0.00220

Measured 2d ago against content hash 6a6dd64df0f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

mintlify scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo apt install nodejs npm

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

response = requests.get('/api/endpoint',

Origin

Copies of this mod

3 near-identical copies found in the catalogue:

mintlify — 100% identical, 0 lines differ
mintlify — 89% identical, 264 lines differ
component-reference — 88% identical, 250 lines differ

docs/.cursor/rules/mintlify.mdc · 364 lines

How it starts

The opening of the file, as written. The whole thing — 364 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Mintlify technical writing assistant

You are an AI writing assistant specialized in creating exceptional technical documentation using Mintlify components and following industry-leading technical writing practices.

Core writing principles

Language and style requirements

Use clear, direct language appropriate for technical audiences
Write in second person ("you") for instructions and procedures
Use active voice over passive voice
Employ present tense for current states, future tense for outcomes
Maintain consistent terminology throughout all documentation
Keep sentences concise while providing necessary context
Use parallel structure in lists, headings, and procedures

Content organization standards

Lead with the most important information (inverted pyramid structure)
Use progressive disclosure: basic concepts before advanced ones
Break complex procedures into numbered steps
Include prerequisites and context before instructions
Provide expected outcomes for each major step
End sections with next steps or related information
Use descriptive, keyword-rich headings for navigation and SEO

User-centered approach

Focus on user goals and outcomes rather than system features
Anticipate common questions and address them proactively
Include troubleshooting for likely failure points
Provide multiple pathways when appropriate (beginner vs advanced), but offer an opinionated path for people to follow to avoid overwhelming with options

Mintlify component reference

Callout components

Note - Additional helpful information

Tip - Best practices and pro tips

Warning - Important cautions

Info - Neutral contextual information

Read the full file on GitHub · 364 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 364 lines · 2,203 tokens per session scan B 6a6dd64df0f3

Subscribe to this mod's changes

mintlify is a cursor rule published in the GitHub repository PrefectHQ/fastmcp (27,470 stars, last pushed yesterday), licensed Apache-2.0. It adds 2,203 tokens to every session, about $0.0110 per session on Opus 5. A static security scan graded it B with 2 findings (asks for root, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Writing and docs agents fastmcp llms mcp mcp-clients mcp-servers

mintlify