# mcp-protocol-stinger

mcp-protocol-stinger — a skill for designing and auditing MCP servers on Claude Code and Codex. Covers tools, schemas, transport, JSON-RPC errors, authentication, testing, and registration across four IDE harnesses.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/skills/mcp-protocol-stinger/SKILL.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-protocol-stinger

## What it does

mcp-protocol-stinger provides a procedural reference for building and verifying MCP server correctness against the specification, @modelcontextprotocol/sdk, and JSON-RPC 2.0. Eight guides address general questions: transport choice (stdio vs HTTP), tool and resource design, zod schemas, error models, capability negotiation, authentication, testing, and server registration in Claude Code, Cursor, Codex, and Cowork. A ninth guide walks through all principles applied to a real agent-memory MCP server.

The skill organizes around guides, audit templates, and worked examples. Each guide ties conclusions to a spec section or SDK symbol so developers verify the reasoning, not just accept it. Core directives: the zod import must be `zod/v3` (v4 breaks schemas), tool names and argument shapes form a cross-harness contract (rename is breaking), and JSON-RPC errors must never be conflated with tool results.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install platform-and-release-tools@wasp-nest
```
This installs the whole platform-and-release-tools plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-protocol-stinger -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-protocol-stinger/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-protocol-stinger/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-protocol-stinger -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-protocol-stinger/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-protocol-stinger -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-protocol-stinger/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install legioncodeinc/vibe-coding-tools plugins/platform-and-release-tools/skills/mcp-protocol-stinger
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-protocol-stinger/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-protocol-stinger -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/legioncodeinc/vibe-coding-tools --path plugins/platform-and-release-tools/skills/mcp-protocol-stinger
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-protocol-stinger/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/skills/mcp-protocol-stinger/SKILL.md

## When to use it
- audit an MCP server for protocol and SDK correctness
- choose between stdio and HTTP transport for an MCP server
- design a tool, resource, or prompt with a correct schema
- route an error to the right channel: JSON-RPC or tool result
- register an MCP server in Claude Code, Cursor, Codex, or Cowork

## Example prompts
- Design an MCP tool for agent memory search with zod/v3 schema and test example
- Audit this MCP server for stdio hygiene issues and zod v4 schema breaks
- How do I register an MCP server in both Claude Code and Cursor?

## Similar
- [mcp-protocol-specialist](https://affpapa.org/en/nevibecode/agents/mcp-protocol-specialist.md) — subagent · 781 installs
- [mcp-server-enhancement](https://affpapa.org/en/nevibecode/skills/mcp-server-enhancement.md) — skill · 2 installs
- [mcp-specialist](https://affpapa.org/en/nevibecode/agents/mcp-specialist.md) — subagent · ★ 328 repo stars
- [competition-custom-protocol-replay](https://affpapa.org/en/nevibecode/skills/competition-custom-protocol-replay.md) — skill · 109 installs
- [mcp-server-architect](https://affpapa.org/en/nevibecode/agents/mcp-server-architect.md) — subagent · 1649 installs
- [MCP Protocol Conformance](https://affpapa.org/en/nevibecode/mcp/mcp-protocol-conformance.md) — MCP server

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
