mcp-builder
Plan and build MCP servers with agent-friendly tools, schemas, error handling, and evaluation. Use when creating or refactoring MCP integrations.
git clone --depth 1 https://github.com/dkyazzentwatwa/chatgpt-skills /tmp/mcp-builder && cp -r /tmp/mcp-builder/mcp-builder ~/.claude/skills/mcp-builderSKILL.md
# MCP Builder Build MCP servers around user workflows, not raw API endpoints. ## Workflow 1. Read the target API docs and identify the workflows an agent must complete end to end. 2. Design a small tool surface with high-signal outputs, clear identifiers, and actionable errors. 3. Implement shared infrastructure first: auth, request helpers, pagination, truncation, and formatting. 4. Add tool schemas and docstrings that make correct usage obvious. 5. Evaluate the server with realistic tasks before expanding scope. ## Principles - Prefer workflow tools over thin endpoint wrappers. - Return concise, high-signal responses by default. - Use human-readable identifiers whenever possible. - Make error messages corrective: tell the agent what to try next. - Design for limited context and large datasets. ## Resources - `references/mcp_best_practices.md` for design principles that apply to every server. - `references/python_mcp_server.md` for Python implementation patterns. - `references/node_mcp_server.md` for TypeScript implementation patterns. - `scripts/connections.py` and `scripts/evaluation.py` as repo-local helpers. ## Deliverables - A concrete tool inventory tied to user workflows. - Strict input/output schemas. - Evaluation prompts or scripts that confirm the server is usable by an agent.
Run multi-indicator technical analysis on crypto or market OHLCV data. Use for deterministic trend, momentum, volume, and divergence analysis.
Analyze datasets and turn them into narrative reports with charts, audits, comparisons, and statistical summaries. Use for exploratory analysis and executive-ready outputs.
Convert PDFs, Office docs, markdown, HTML, and tables between editable formats. Use for best-effort document conversion, PDF utilities, form filling, and table extraction.
Run loan, investment, NPV, retirement, savings, and risk calculations with schedules and charts. Use for deterministic financial modeling tasks.
Parse, convert, geocode, visualize, and measure geographic data. Use for address cleanup, geo file conversion, mapping, and distance workflows.
Process images for cleanup, conversion, metadata, comparison, icons, palettes, collages, and sprite sheets. Use for single-image or batch image workflows.
Process audio and video with clipping, conversion, analysis, captions, thumbnails, GIFs, and batch utilities. Use for practical media manipulation workflows.
Extract text and structure from scans, images, and scanned PDFs. Use for OCR, searchable PDFs, table extraction, receipt parsing, and business card parsing.