while comprehensive coverage gives agents flexibility to compose operations. Performance varies by client—some clients benefit from code execution that combines basic tools

Mar 20, 2026

Coding & Debugging

PromptBeginner5 minmarkdown

Agents benefit from concise tool descriptions and the ability to filter/paginate results. Design tools that return focused

relevant data. Some clients support code execution which can help agents filter and process data efficiently.

Mar 20, 2026

Coding & Debugging

PromptBeginner5 minmarkdown

description: Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services

whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

Mar 20, 2026

Writing & Content

PromptBeginner5 minmarkdown

5. Encourage exploration beyond typical ad norms

blending storytelling

Mar 20, 2026

Find agent skills by outcome

textContent = JSON.stringify(output

This tool searches across all user profiles in the Example platform

│ └── constants.ts # Shared constants (API_URL

- **DO NOT use**: Old deprecated APIs such as `server.tool()`

content: [{ type: text

After inspecting the content

<question>Look for pull requests that modified files in the /api directory and were merged between January 1 and January 31

- Goal: identify specific content (e.g.

After understanding the API and tools

- Questions must be designed so there is a single

- Look at old content (e.g.

return { content: [{ type: text

- Store API keys in environment variables

3. **Be action-oriented**: Start with verbs (get

- **Python**: `{service}_mcp` (e.g.

- **MCP Protocol**: Start with sitemap at `https://modelcontextprotocol.io/sitemap.xml`

Prioritize comprehensive API coverage. List endpoints to implement

- [🐍 Python Guide](./reference/python_mcp_server.md) - Module organization

- **Language**: TypeScript (high-quality SDK support and good compatibility in many execution environments e.g. MCPB. Plus AI models are good at generating TypeScript code

Review the service's API documentation to identify key endpoints

Balance comprehensive API endpoint coverage with specialized workflow tools. Workflow tools can be more convenient for specific tasks

Agents benefit from concise tool descriptions and the ability to filter/paginate results. Design tools that return focused

description: Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services

5. Encourage exploration beyond typical ad norms

- DO NOT use: Old deprecated APIs such as `server.tool()`

3. Be action-oriented: Start with verbs (get

- Python: `{service}_mcp` (e.g.

- MCP Protocol: Start with sitemap at `https://modelcontextprotocol.io/sitemap.xml`

- Language: TypeScript (high-quality SDK support and good compatibility in many execution environments e.g. MCPB. Plus AI models are good at generating TypeScript code