skills.rest
AvaTar-ArTs
AvaTar-ArTsCOMMUNITY
Explore all skills by this author →
GitHub

build-mcp-server

Guides developers through designing and scaffolding Model Context Protocol servers for Codex.

Updated Jul 10, 2026
Search Tags:#oauth#codex#mcp#api integration#model context protocol#tool design#server scaffolding
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill build-mcp-server-avatar-arts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-mcp-server
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/build-mcp-server
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill build-mcp-server-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Choosing the wrong MCP server architecture early leads to painful rewrites. This Skill prevents that by interrogating your use case first, then recommending the right deployment model, tool-design pattern, framework, and auth approach before any code is written. ## Core Features & Use Cases - Structured Discovery: Asks targeted questions about what the server connects to, who uses it, how many actions it exposes, and what auth it needs. - Deployment Recommendations: Chooses between remote streamable-HTTP servers, MCP apps with interactive UI widgets, MCPB bundled local servers, or local stdio prototypes. - Tool-Design Patterns: Applies one-tool-per-action for small API surfaces or the search-plus-execute pattern for large APIs with dozens of endpoints. - Use Case: A developer wants to wrap a SaaS REST API for Codex. The Skill determines a remote HTTP server on Cloudflare Workers with the TypeScript SDK is the right fit, then scaffolds it or hands off to the build-mcp-app or build-mcpb skills. ## Quick Start Ask the assistant to help you build an MCP server that wraps your API and answer its discovery questions about users, actions, and authentication.

Frequently Asked Questions about build-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server for Codex?▼

Start by defining what the server connects to, who uses it, and how many actions it exposes. For cloud APIs, build a remote streamable-HTTP server with the TypeScript SDK or FastMCP; for local resources, package it as an MCPB bundle instead.

What deployment model should I choose for an MCP server?▼

Remote streamable-HTTP is the default recommendation for anything wrapping a cloud API because users just add a URL. Choose MCPB when the server must access local files, desktop apps, or OS-level APIs on the user's machine.

TypeScript SDK vs FastMCP for MCP server development?▼

The official TypeScript SDK (@modelcontextprotocol/sdk) has the best spec coverage and gets new features first. FastMCP 3.x suits Python developers or those wrapping Python libraries, offering decorator-based low-boilerplate server definitions.

How do I handle many API endpoints in one MCP server?▼

Use the search-plus-execute pattern: expose a search_actions tool that matches natural-language intent to actions and an execute_action tool that runs them by ID. This keeps the context window lean instead of listing hundreds of tool schemas.

Does MCP support asking users for input during a tool call?▼

Yes, elicitation lets the server send a flat JSON schema mid-tool and the host renders a native form. Host support is recent (Codex v2.1.76+), so always check clientCapabilities.elicitation and provide a fallback.

When should I not use local stdio for an MCP server?▼

Local stdio via npx or uvx is fine for personal prototypes but painful to distribute, since users need the right runtime and updates cannot be pushed. For distributable local servers, package as MCPB instead.

Related Skills

Explore More Software Engineering Skills→
vercel-labsvercel-labs
1.5k

stripe

Simulate the Stripe API locally for payment processing and webhook testing.

Official
Intermediate
timequitytimequity
6

advanced

Automate creation and publication of Claude Code extensions.

Official
Advanced
fazxesfazxes
231

build-mcp-app

Build and deploy MCP apps with inline UI widgets for chat surfaces.

Community
Advanced
ferrarifankid04ferrarifankid04

system-connector

Build deterministic Node.js connectors to third-party APIs and systems.

Community
Advanced