Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Anthropic

design-mcp-workflow — Claude Code skill: plan MCP integration

This skill helps you decide whether a task needs MCP or REST API is enough, and plan a hybrid architecture. Use it when designing tool-based workflows for Claude.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add anthropics/knowledge-work-plugins --skill design-mcp-workflow -a claude-code
Open on GitHub

What design-mcp-workflow does

The skill walks you through the decision: determines if a task is agentic (needs tools), deterministic (automation), or both. Then routes work — sends MCP-only tasks to zoom-mcp, hybrid tasks to both services, and if Whiteboard is central, directs there via zoom-mcp/whiteboard.

As you design, the skill explicitly surfaces assumptions: transport, auth, client capabilities. This separates MCP from REST API at the architecture level, so you do not use MCP for deterministic backend jobs that belong in REST, and do not confuse MCP with replacing your entire API design.

Available on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.

What it helps with

  • assess whether MCP fits a specific task
  • draw boundaries between MCP and REST API
  • design a hybrid architecture with tools
  • document assumptions about transport and auth
  • route Whiteboard tasks to the right service

Example prompts for the agent

  • I have a Zoom workflow in Claude, should I use MCP or REST API?
  • Design an MCP workflow: agentic parts as tools, deterministic parts as API
  • Help me separate MCP responsibility from REST in my architecture

How to install design-mcp-workflow

1Skills CLI (Vercel)

npx skills add anthropics/knowledge-work-plugins --skill design-mcp-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/design-mcp-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-mcp-workflow/

From the same set89

The whole set →
data-visualization official anthropics Selects chart types based on data structure and produces Python visualization code in matplotlib, seaborn, and plotly. Useful for reports and research figures. Claude Code CX Codex Cursor +1 13,700installs documentation official anthropics A skill for technical writing that drafts READMEs, API references, runbooks, architecture docs and onboarding guides. Useful when the code exists but the description does not. Claude Code CX Codex Cursor +1 10,300installs build-dashboard official anthropics Builds a self-contained HTML dashboard with Chart.js charts, KPI cards, and filterable tables. Useful for turning raw data or queries into a standalone browser report. Claude Code CX Codex Cursor +1 9,100installs memory-management official anthropics This skill organizes workplace shorthand, names, and project details into files an agent can consult. It fits projects where requests rely on an internal vocabulary and shared context. Claude Code CX Codex Cursor +1 7,400installs task-management official anthropics Tracks commitments, active work, and follow-ups in a local TASKS.md file. Useful when managing project to-dos directly from the AI coding chat. Claude Code CX Codex Cursor +1 7,200installs architecture official anthropics Writes an Architecture Decision Record or reviews a system design: options, trade-offs, consequences. Useful when you have to pick between technologies. Claude Code CX Codex Cursor +1 6,700installs knowledge-synthesis official anthropics Merges search results across chats, emails, and documents into deduplicated answers with source attribution. Flags conflicting facts and scores source reliability. Claude Code CX Codex Cursor +1 6,400installs testing-strategy official anthropics This skill designs testing strategies and test plans for a project. Use it when you need test types, coverage goals, or gaps in existing checks. Claude Code CX Codex Cursor +1 6,400installs

Similar

claude-to-im op7418 Forwards Claude replies to Telegram, Discord, Feishu, QQ or WeChat. Chat with the agent from your phone while the session stays on desktop. Claude Code CX Codex Cursor +1 7,100installs minimax-docx nexu-io A skill for creating and editing DOCX files with OpenXML SDK. Handy for branded reports, proposals, and template-based documents. Claude Code CX Codex Cursor +1 2,700installs artifacts-builder nexu-io A skill designed for generating multi-component claude.ai HTML artifacts. It uses React and Tailwind CSS alongside shadcn/ui components. Claude Code CX Codex Cursor +1 2,700installs parallel-debugging Seth Hobson This skill investigates complex bugs by testing competing hypotheses in parallel. Use it when an issue has several plausible causes or crosses multiple components. Claude Code CX Codex Cursor 10,000installs kyc-rules official anthropics Applies your firm's KYC/AML rules grid to a parsed onboarding record, assigns a risk rating, and routes the case — to doc request, enhanced due diligence, or decline. Works after kyc-doc-parse. Claude Code CX Codex Cursor +1 1,200installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs

Questions about design-mcp-workflow

How do I install design-mcp-workflow in Claude Code?

Run npx skills add anthropics/knowledge-work-plugins --skill design-mcp-workflow -a claude-code, then find the skill at ~/.claude/skills/design-mcp-workflow/SKILL.md.

When should I use design-mcp-workflow?

When you need to decide if MCP suits a task, plan a tool-based workflow for Claude, or separate responsibilities between MCP and REST API.

How is MCP different from REST API?

MCP is a tool interface for agentic tasks where Claude calls functions. REST API is deterministic code that follows a script. This skill helps you choose the right approach for each part of your workflow.

Source text

SKILL.md · Apache-2.0 
---
name: design-mcp-workflow
description: Design a Zoom MCP workflow for Claude. Use when deciding whether Zoom MCP fits a task, when planning tool-based AI workflows, or when separating MCP responsibilities from REST API responsibilities.
user-invocable: false
---

# Design MCP Workflow

Use this skill when the user wants Claude or another MCP-capable client to interact with Zoom via tool calls instead of only deterministic API code.

## Covers

- MCP fit assessment
- REST API vs MCP boundaries
- Hybrid architectures
- Connector expectations
- Whiteboard-specific MCP routing

## Workflow

1. Decide whether the problem is agentic tooling, deterministic automation, or both.
2. Route MCP-only tasks to [zoom-mcp](../zoom-mcp/SKILL.md).
3. Route hybrid tasks to both [zoom-mcp](../zoom-mcp/SKILL.md) and [rest-api](../rest-api/SKILL.md).
4. If Whiteboard is central, route to [zoom-mcp/whiteboard](../zoom-mcp/whiteboard/SKILL.md).
5. Call out transport, auth, and client capability assumptions explicitly.

## Common Mistakes

- Using MCP for deterministic backend jobs that should stay in REST
- Treating MCP as a replacement for all API design
- Ignoring client transport support and auth requirements

© anthropics · Apache-2.0 · anthropics/knowledge-work-plugins

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor