Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIGitHub CopilotGitHub CopilotGemini CLIGemini CLI+20 more

    MCP Server Architect

    1

    Give it your API and your use case; it returns an MCP design that works in practice, not just in a demo.

    $5

    Secure checkout via Stripe

    30-day refund guarantee

    Converts to your local currency at checkout

    0 installsSecurity scanned
    MCP Server Architect

    MCP Server Architect

    Example session with this skill installed

    We have a REST API for our project-management tool with about 60 endpoints covering projects, tasks, comments, users and labels. We want an MCP server so Claude can triage and update tasks for a user. Auth is OAuth2 with per-user tokens.

    • Read your context and instructions
    • Compiled the mcp server architect
    • Generated the document

    MCP tool surface for task triage: 60 endpoints consolidated into 6 task-first tools, with curated responses and per-user OAuth.

    Tool surface

    ToolWrapsPurpose
    find_taskslist tasks, labels, usersSearch by text, status, assignee, label
    get_tasktask, comments, labelsOne call for full context
    update_taskstatus, assignee, labels, due dateSingle edit tool
    add_commentcommentsLeave a triage note
    create_tasktasksNew task in a project
    list_projectsprojectsPick a project by name

    Schema and description (written as a prompt)

    { "name": "update_task",
  "description": "Change a task's status, assignee, labels or due date. Use find_tasks first to get the task_id. Only pass fields you want to change.",
  "inputSchema": { "type": "object", "required": ["task_id"],
    "properties": { "task_id": {"type": "string"},
      "status": {"enum": ["todo","in_progress","blocked","done"]},
      "assignee_email": {"type": "string"} } } }

    Response curation

    Return id, title, status, assignee, labels and a short comment summary. Drop internal IDs, audit fields and HTML bodies. Cap lists and return a cursor.

    Auth

    Use the MCP authorization flow with OAuth2 so each call runs with the user's own token. Never share a service token.

    Next steps

    • Map each tool to its underlying endpoints
    • Test descriptions with real triage prompts

    mcp-server-architect.pdf

    PDF · document

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    What you get

    Design task-oriented tool schemas from raw API docs.Optimize tool descriptions for better model reliability.Define resource vs tool splits for context efficiency.Apply best practices for MCP auth and error handling.Build an MCP server (Model Context Protocol) from scratchFix an agent that gets confused by too many toolsWrite MCP tool descriptions the model actually picks correctly

    About this skill

    The default MCP server is an API wrapper that dumps forty endpoint-shaped tools on the model and hopes — and the model gets confused, picks the wrong tool, and produces garbage that looks like a tool call. Good MCP design is a different craft: composing tools at the right abstraction level (not too granular, not too broad), writing descriptions the model actually uses to pick correctly, designing the resource and prompt primitives that make your server genuinely useful rather than technically compliant, and handling the auth and error surface that breaks most MCP integrations in production. This skill architects your MCP server from the tool inventory up: what tools to expose, how to describe them, what to bundle vs. split, how to handle state across calls, and how to test that the model actually uses it correctly. Give it your API and your use case; it returns an MCP design that works in practice, not just in a demo.

    How to install

    Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.

    ~30 seconds
    1. 1

      Download the ZIP

      Free skills download straight away. Paid skills unlock right after purchase.

    2. 2

      Unzip into your skills folder

      Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.

    3. 3

      Ask your agent to use it

      Restart the agent if it was already running. It picks the skill up automatically - no config needed.

    Skills folder by agent

    Click the path to copy it. Create the folder if it does not exist yet.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 3 months ago

    • Passed all security checks, Safe to install

    Listed3 months ago
    Updated11 days ago

    What's inside

    Frequently Asked Questions