Skip to content
cccskills
FreePublished on GitHub

mcp-builder

Build and troubleshoot MCP servers, which connect AI agents to external tools, for codewhale. Covers local and remote connections, credential configuration, tool validation, and testing both successful requests and failures.

OriginalShow the original description

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

See how to install

Good for

  • Building an MCP server for a local tool
  • Connecting codewhale to a remote service
  • Configuring credentials and connection headers
  • Debugging MCP connections and tool failures

Files included (1)

  • SKILL.md1.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

batch

FreeSummary

Split a large goal into clearly bounded tasks that can run in parallel. Coordinate existing agent and worktree tools, then combine and verify the results. The skill starts only when explicitly requested.

  • Splitting a large goal into parallel tasks
  • Coordinating work across multiple agents
  • Running tasks in separate worktrees
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

best-of-n

FreeSummary

Generate independent options for design, implementation, explanations, or debugging, then compare them using one shared rubric. Code candidates use separate working copies and undergo independent verification before a winner is presented for review.

  • Comparing several plausible design approaches
  • Evaluating independent implementations of the same task
  • Comparing explanations or debugging approaches
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

Check Codewhale release readiness through ordered tests, builds, version checks, and manual terminal checks. Record command results and observed behavior, including responsiveness, route isolation, and follow-up input handling, while explicitly identifying any skipped checks.

  • Run automated checks on the actual release branch
  • Check whether a PR merges into the release branch
  • Manually test terminal responsiveness and input behavior
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

computer-use

FreeSummary

Operate desktop apps and isolated browsers on registered computers by inspecting interface controls, entering information, and checking results. The skill also covers screenshots and recording, with separate routing for the user's signed-in Chrome through Chromewhale.

  • Entering information through a desktop app interface
  • Working in an isolated browser session
  • Capturing screenshots or recordings for a task
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

Check a local Codewhale checkout before contributing: inspect branch and sync status, build the CLI, and run the repository’s CI checks. Present recent commits and changelog entries from local files, with clear status for each step.

  • Checking a checkout before contributing
  • Reviewing local changes and sync status
  • Running the build and CI verification commands
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

cw-dogfood

FreeSummary

Builds and installs Codewhale with a source revision identifier, then verifies the installed version in a fresh shell. It guides hands-on runtime checks for interface behavior, routing, approvals, and other changes that automated tests may miss.

  • Verifying terminal interface changes in the actual product
  • Installing and checking a local release build
  • Checking model routing and approval behavior
codewhale-hq/Codewhale41.1KUpdated Oct 19, 2026

See all skills by codewhale-hq

Report a problem with this skill