mcptoon MCP Server Entry Authoring
Guides Claude to add or edit MCP server entries in mcptoon's config.json with the correct shape, command rules, and validation loop.
Dev & CodingIntermediate★ 202⑂ 8AI score 8/10Last updated: Sep 19, 2026
What it does
- Produces correctly shaped entries under
mcpServersin~/.mcptoon/config.jsonfor stdio, streamable-http, and sse transports. - Enforces hard rules for stdio
command: a single executable token only, no shell strings, nobash -c, no absolute paths — metacharacters go inargs. - Explains Agent Plugin placeholders
${PLUGIN_ROOT}and${PLUGIN_DATA}, plus the rule that plugin-managed entries are updated by reinstalling, not hand-editing. - Always closes with the validation loop:
mcptoon doctor→mcptoon list→mcptoon health.
Who it's for
- Developers managing several MCP servers through mcptoon.
- Anyone who keeps hitting shape or path errors when hand-writing MCP config JSON.
- MCP server authors shipping their server as an Agent Plugin.
Examples
- "Add the filesystem MCP server rooted at /data" → generates an npx-based stdio entry and verifies with doctor/health.
- "Register the remote endpoint https://example.com/mcp" → generates a streamable-http entry.
- Instead of hand-writing JSON from docs, it steers you to
mcptoon install --npm/--pip/--urlso the shape is generated correctly.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/activeing123/mcptoon/HEAD/plugin/mcptoon-skills/skills/authoring/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the plugin/mcptoon-skills/skills/authoring folder from the GitHub repo activeing123/mcptoon into my ~/.claude/skills/activeing123-authoring/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon && mkdir -p ~/.claude/skills && cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/authoring ~/.claude/skills/mcptoon-authoring⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repository:
git clone https://github.com/activeing123/mcptoon.git /tmp/mcptoon - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/mcptoon/plugin/mcptoon-skills/skills/authoring ~/.claude/skills/mcptoon-authoring - Confirm the CLI is available:
mcptoon --version(install it per the repo README if missing). - Restart Claude Code and ask it to "add an MCP server to mcptoon" to trigger the skill.
View source on GitHub ↗License: Apache-2.0