This walks you through building MCP servers that let LLMs interact with external APIs and services, covering both Python (FastMCP) and TypeScript implementations. The guidance focuses on designing tools for actual agent workflows rather than just wrapping API endpoints. Think consolidating related operations into single high-impact tools, optimizing responses for limited context windows, and writing error messages that guide the LLM toward correct usage. It includes a four-phase approach from research (fetching live MCP protocol docs) through implementation, code review, and creating evaluation tests. The eval framework is smart: questions must be independent, read-only, and require multiple tool calls to answer, which forces you to validate that your server actually enables complex workflows.

GitHub stars
1.7K
last updated
May 1, 2026

Install

$ npx -y skills add composiohq/awesome-claude-plugins --skill mcp-builder --agent claude-code

Installs into .claude/skills of the current project.

Files

MCP Server Development Guide

Overview

To create high-quality MCP (Model Context Protocol) servers that enable LLMs to effectively interact with external services, use this skill. An MCP server provides tools that allow LLMs to access external services and APIs.

High-Level Workflow

Creating a high-quality MCP server involves four main phases:

Phase 1: Deep Research and Planning

Agent-Centric Design Principles

Build for Workflows, Not Just API Endpoints:

  • Don't simply wrap existing API endpoints - build thoughtful, high-impact workflow tools
  • Consolidate related operations (e.g., schedule_event that both checks availability and creates event)
  • Focus on tools that enable complete tasks, not just individual API calls

Optimize for Limited Context:

  • Agents have constrained context windows - make every token count
  • Return high-signal information, not exhaustive data dumps
  • Provide "concise" vs "detailed" response format options
  • Default to human-readable identifiers over technical codes

Sponsors

Details

Repository
github.com/composiohq/awesome-claude-plugins
Categories
Documentation, Code Review & Quality, AI & Agent Building, Python
First seen
Jun 11, 2026

More from composiohq/awesome-claude-plugins

All 23
1cryfs avatarasync-dropcryfs/cryfsGuide to the AsyncDrop pattern for async cleanup in Rust. Use when working with AsyncDropGuard, implementing AsyncDrop trait, or handling async resource cleanup0skills.sh installs
2davila7 avatarEthical Hacking Methodologydavila7/claude-code-templatesThis skill should be used when the user asks to "learn ethical hacking", "understand penetration testing lifecycle", "perform reconnaissance", "conduct security0skills.sh installs
3ganyuanran avatarrecording-architecture-decisionsganyuanran/aegisThis one helps you write architecture decision records without leaving your baseline documentation stale.0skills.sh installs
4heshengtao avatarskill-creatorheshengtao/super-agent-partyGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabil0skills.sh installs
5hoangsonww avatarrelease-guardhoangsonww/claude-code-agent-monitorRun release-readiness checks for this repository. Use when validating docs, scripts, verification coverage, and operational safety before merge or release.0skills.sh installs
6hoangsonww avatarship-featurehoangsonww/claude-code-agent-monitorImplement a feature safely end-to-end in this repository. Use when adding or changing functionality across backend, frontend, or MCP with required verification 0skills.sh installs