# MCP Builder

Design, build, configure, or debug Model Context Protocol servers for codewhale...

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill mcp-builder -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill mcp-builder -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill mcp-builder -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill mcp-builder -g -a gemini-cli -y`

## Description

Design, build, configure, or debug Model Context Protocol servers for codewhale, including stdio and HTTP/SSE transports.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MCP Builder

Use this skill when the user asks to create, configure, or debug an MCP server
or tool integration.

## Design Rules

- Prefer stdio MCP servers for local tools and HTTP/SSE for remote services.
- Keep tool schemas small, typed, and explicit. Return structured JSON where
  possible.
- Put secrets in environment variables, never in committed config.
- For HTTP/SSE clients, send `Accept: application/json, text/event-stream` by
  default unless the server explicitly requires something else.
- Add timeouts and clear error messages around external APIs.

## Codewhale Setup

Common commands:

```bash
codewhale mcp init
codewhale mcp add my-server --command node --arg server.js
codewhale mcp add remote-server --url http://127.0.0.1:3000/mcp
codewhale mcp list
codewhale mcp validate
codewhale mcp tools
```

HTTP/SSE entries can include per-server headers in `~/.codewhale/mcp.json` when
credentials or custom routing headers are required.

## Workflow

1. Define the service boundary and the minimum useful tools.
2. Choose transport and credential handling.
3. Implement the server using a maintained MCP SDK when available.
4. Add the server with `codewhale mcp add` or edit `~/.codewhale/mcp.json`.
5. Run `codewhale mcp validate`, then `codewhale mcp tools`.
6. Test one happy path and one failure path before calling it done.