mcp-builder

Guide building MCP servers in TypeScript and Python for HTTP and stdio transports.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/makerjackie/jackie-skills-starter --skill mcp-builder-makerjackie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/makerjackie/jackie-skills-starter/tree/main/skills/mcp-builder
Command: npx skills add https://github.com/makerjackie/jackie-skills-starter --skill mcp-builder-makerjackie

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provide a comprehensive, opinionated guide and reference for designing and implementing MCP (Model Context Protocol) servers so that LLMs can reliably interact with external APIs and services.

Core Features & Use Cases

  • Design Guidance: Advice on API coverage vs. workflow tools, tool naming, context management, and actionable error messages.
  • Language Guides: Detailed TypeScript and Python implementation patterns, including Zod and Pydantic schemas, transport choices (stdio vs streamable HTTP), and project structure.
  • Testing & Evaluation: Evaluation harness, example evaluation files, and recommendations for building stable, verifiable evaluation suites to measure how well LLMs use the MCP server.
  • Utilities & Examples: Connection helper scripts, example server patterns, and best-practice checklists for security, pagination, and error handling.

Quick Start

Ask the AI to scaffold a TypeScript or Python MCP server that registers tools with strict input schemas, includes connection helpers, and adds an evaluation XML with 10 read-only QA pairs.

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 for API integrations?

To build an MCP server for API integrations, follow implementation patterns for TypeScript and Python that register tools with strict input schemas, handle transport selection, and manage pagination. This ensures LLMs reliably interact with external services.

What is the difference between stdio and streamable HTTP transports for MCP servers?

The difference between stdio and streamable HTTP transports for MCP servers involves how connections are managed: stdio is typically used for local agent workflows, while streamable HTTP supports broader API integrations. Transport selection depends on your specific use case.

Can I use Python and TypeScript to create MCP servers?

Yes, you can use Python and TypeScript to create MCP servers. The guide provides detailed implementation patterns for both languages, utilizing Pydantic schemas for Python and Zod schemas for TypeScript to ensure strict input validation.

How do I test and evaluate LLM interactions with an MCP server?

To test and evaluate LLM interactions with an MCP server, use the provided evaluation harness and example evaluation files. You can build stable, verifiable evaluation suites with read-only QA pairs to measure how well the LLM uses the server.

What are the best practices for MCP server tool naming and error handling?

Best practices for MCP server tool naming and error handling include applying design guidance for actionable error messages and proper context management. Following these patterns ensures the server remains stable and the LLM receives clear, operational feedback.

Does building an MCP server require manual schema validation?

Building an MCP server does not require manual schema validation if you use Zod for TypeScript or Pydantic for Python. These frameworks enforce strict input schemas automatically, reducing errors in API integrations and tooling workflows.