IMPORTANT: How to Use This Skill

Mandatory reference guide for building production MCP servers with tools, resources, prompts, and widgets.

- Covers foundational concepts (Tool, Resource, Prompt, Widget primitives), server architecture, authentication patterns (OAuth, Supabase, custom), and deployment strategies

- Includes detailed guides for implementing tools, resources, prompts, response formatting, and widget-based UIs with state management and theming

- Documents common anti-patterns (missing validation, improper error handling, widget state mistakes) and golden rules (one tool per capability, widgets own their state, validate at boundaries)

- Provides decision trees, quick references, and end-to-end examples for weather apps, todo lists, and other common use cases

IMPORTANT: How to Use This Skill

This file provides a NAVIGATION GUIDE ONLY. Before implementing any MCP server features, you MUST:

- Read this overview to understand which reference files are relevant

- ALWAYS read the specific reference file(s) for the features you're implementing

- Apply the detailed patterns from those files to your implementation

Do NOT rely solely on the quick reference examples in this file - they are minimal examples only. The reference files contain critical best practices, security considerations, and advanced patterns.

MCP Server Best Practices

Comprehensive guide for building production-ready MCP servers with tools, resources, prompts, and widgets using mcp-use.

⚠️ FIRST: New Project or Existing Project?

Before doing anything else, determine whether you are inside an existing mcp-use project.