agentsclimarketplace
Sign in

Mcp server design

Skill batteryshark/skill-tap/skills/development/mcp/mcp-server-design

Design FastMCP 3 tools, providers, transforms, authorization, background work, output contracts, and human approval boundaries for a production server.From its SKILL.md

Install
npx -y skills add batteryshark/skill-tap --skill mcp-server-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.7 KB, 292 tokens by cl100k_base, as published. Nobody here has run it

Design a FastMCP Server

  1. Inventory users, component count, data sources, trust boundaries, latency, long-running work, and irreversible or external effects.
  2. Run bin/mcp-server-design PATH to inventory existing FastMCP concerns and read references/architecture-decisions.md.
  3. Keep domain logic library-first. Use providers to source components, transforms to shape the exposed catalog, and middleware for request execution concerns.
  4. Prefer ordinary directly exposed tools for a small catalog. Use Tool Search for on-demand discovery, and experimental Code Mode only when server-side Python composition justifies its sandbox and extra dependency.
  5. Make output match consumers: typed structured data for programmatic composition, concise content for model reading, and Apps when an interactive UI materially helps. Do not impose a universal text-only rule.
  6. Put authorization and visibility on components, authenticate HTTP deployments, keep secrets server-side, and require preview/approval for irreversible, financial, external-communication, permission, or sensitive-data actions.
  7. Use task support for genuinely long-running work and explicit timeouts for bounded calls. Keep interactive OAuth and unreliable network work out of startup.
  8. Verify schemas, catalog exposure, permissions, output shape, task behavior, and side-effect gates.

Use agents/architecture-reviewer.md for a threat- and token-budget-aware review.

What ships with it: 4 files

3.6 KB alongside SKILL.md, 2 of them executable

agents/

bin/

references/

scripts/

Gives 0 of the 12 instructions most design frontend skills give in 292 tokens

Counted across 1,169 of the 1,878 authors here whose files we hold, read 2026-08-07

  • Use CSS variables for color consistencyin 72 of 1169, across 23 files
  • Commit to one bold aesthetic direction before codingin 72 of 1169, across 27 files
  • Match implementation complexity to the aesthetic visionin 70 of 1169, across 20 files
  • Add atmospheric background effects and texturesin 57 of 1169, across 9 files
  • Use unexpected spatial compositions and layoutsin 56 of 1169, across 8 files
  • Implement real working codein 55 of 1169, across 7 files
  • Vary themes and aesthetics across different designsin 48 of 1169, across 7 files
  • Launch chromium in headless modein 47 of 1169, across 4 files
  • Close the browser when donein 47 of 1169, across 4 files
  • Run provided scripts with help flag firstin 47 of 1169, across 4 files
  • Wait for network idle statein 47 of 1169, across 4 files
  • Use descriptive selectors for elementsin 47 of 1169, across 4 files

Said here and by no other author read

  • inventory system concerns
  • keep domain logic library first
  • use providers for components
  • use transforms for catalog shaping
  • use middleware for execution concerns
  • match output to consumers

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 326,782. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.