mcp-builder

Guides building and evaluating MCP servers in Python or TypeScript.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill mcp-builder-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/anthropic-skills/skills/mcp-builder
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill mcp-builder-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires anthropic, mcp, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building MCP (Model Context Protocol) servers that LLMs can actually use effectively requires careful tool design, schema validation, transport selection, and evaluation—this Skill provides a structured four-phase workflow covering research, implementation, review, and evaluation. ## Core Features & Use Cases - Guided Development Workflow: Walks through research, planning, implementation, and testing phases for MCP servers in Python (FastMCP) or TypeScript (MCP SDK). - Language-Specific References: Includes detailed implementation guides covering Zod/Pydantic schemas, tool registration, pagination, error handling, and transport configuration (stdio vs streamable HTTP). - Evaluation Harness: Ships Python scripts to create XML-based evaluation question sets and run automated LLM-driven tests against your MCP server, producing accuracy reports. - Use Case: You want to expose the GitHub API to an LLM agent. Use this Skill to design well-named tools with proper annotations, implement them in TypeScript, then generate 10 complex read-only evaluation questions and measure how well an LLM answers them using your server. ## Quick Start Ask the AI to help you build an MCP server for your chosen API, specifying whether you want Python or TypeScript.

Frequently Asked Questions about mcp-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server in Python or TypeScript?

Use FastMCP for Python or the official MCP TypeScript SDK with server.registerTool. Define input schemas with Pydantic or Zod, add tool annotations like readOnlyHint, and test with the MCP Inspector before deployment.

Should I use stdio or streamable HTTP for my MCP server?

Use stdio for local integrations and command-line tools where the server runs as a subprocess. Use streamable HTTP for remote servers serving multiple clients, preferably with stateless JSON responses for simpler scaling.

How do I test whether my MCP server works well with LLMs?

Create an XML evaluation file with 10 complex, read-only questions having single verifiable answers, then run the evaluation.py script with your transport type. It reports accuracy, tool call counts, and agent feedback on your tool design.

What makes a good MCP tool description?

Good descriptions concisely state functionality, document all parameters with types and constraints, specify return value schemas, and include usage examples. Error messages should suggest concrete next steps rather than generic failure notices.

Why should MCP evaluation questions avoid current-state queries?

Answers based on dynamic state like open issue counts change over time, breaking verification. Questions should target historical, closed data with stable answers verifiable through direct string comparison.