Build MCPB

Build MCP servers end-to-end: scaffold from API docs, implement tools, validate the bundle, create an embedded skill resource, and release to the mpak registry. Supports Python (FastMCP) and TypeScript (@modelcontextprotocol/sdk).

Quick Start

/build-mcpb

Pipeline

Work through each phase in order. Read the linked workflow file for detailed instructions. Each phase has a gate that must pass before proceeding.

• Phase 0 — Bootstrap: Language, service name, repo creation, template setup. Read references/workflow/phase-0-bootstrap.md
• Phase 1 — API Analysis: Fetch docs, identify resources, propose tools for approval. Read references/workflow/phase-1-api-analysis.md
• Phase 2 — Scaffold: Verify project structure from template. Read references/workflow/phase-2-scaffold.md
• Phase 3 — Implement & Verify: Write tool logic, models, client; lint, typecheck, test. Read references/workflow/phase-3-implement-and-verify.md
• Phase 4 — Validate Bundle: Manifest, build, bundle, MTF scan, runtime. Read references/workflow/phase-4-validate-bundle.md
• Phase 5 — Embed Skill: Create in-package skill resource, wire, verify. Read references/workflow/phase-5-embed-skill.md
• Phase 6 — Release: Commit, push, cut release, verify publication. Read references/workflow/phase-6-release.md

References

• references/CONVENTIONS.md — Naming, manifest format, versioning, build system, entry points
• references/PATTERNS.md — Complete code patterns, directory structures, CI workflows
• references/SKILL_FORMAT.md — Embedded skill resource format and wiring patterns