MCP Server Development Prompt
Create a Model Context Protocol (MCP) server with FastMCP or TypeScript SDK following best practices

Customize this template
Build your prompt
Generate Your Prompt
Fill in the required details first. Optional controls help you fine-tune the result.
What external service or API will this MCP server interact with?
What will users accomplish with this MCP server?
Python (FastMCP) or TypeScript (MCP SDK)?
What tools/capabilities must this server provide?
See a completed example
GitHub MCP Server
Input Variables
Questions about this prompt
Best Practices
Critical Best Practices
Use Tool Preambles
criticalProvide clear progress updates before calling tools so users can follow the agent's work. This improves transparency and user experience during long operations.
Example:
“Before calling search tools, explain: "I'm going to search our knowledge base for recent updates on this topic..."”
Define Persistence Behavior
criticalSpecify when the agent should continue working vs. asking for clarification. Set clear stop conditions to avoid premature termination or endless loops.
Example:
“Only stop when: (1) Task is fully complete, (2) User explicitly asks to stop, or (3) You encounter an unrecoverable error.”
Define Error Handling Strategy
criticalSpecify how agents should handle errors, missing data, and edge cases. Should they retry, escalate, or proceed with uncertainty?
Set Safety Boundaries
criticalDefine which actions require confirmation (destructive operations, external API calls, file deletions) vs. which can be done autonomously.
Example:
“Ask before: deleting files, making API calls that cost money, or modifying production databases.”
Recommended Best Practices
Enable Parallel Tool Execution
recommendedAllow agents to call multiple independent tools simultaneously for faster execution. Critical for research and multi-step workflows.
Example:
“When gathering context, run file reads and searches in parallel rather than sequentially.”