build-mcp-server-sdk-v1
Build MCP Server (SDK v1.x)
Build and maintain MCP servers using @modelcontextprotocol/sdk v1.x — the single-package, Zod-based TypeScript SDK (protocol version 2025-11-25). Covers McpServer, registerTool, registerResource, registerPrompt, transports, OAuth 2.1, sessions, and deployment.
When to use this skill
- Building a new MCP server on
@modelcontextprotocol/sdkv1.x (single package) - Adding tools, resources, or prompts to an existing v1 server
- Migrating a v1 server from deprecated APIs (
tool(),SSEServerTransport, raw JSON Schema) to current ones (registerTool,StreamableHTTPServerTransport, Zod) - Wiring authentication on a v1 server — bearer token, OAuth 2.1 via
mcpAuthRouter, or custom middleware - Hardening transports, sessions, or capabilities on a v1 server (Origin validation, session resumability, sampling/elicitation)
- Diagnosing v1-specific runtime errors —
RequestHandlerExtraaccess, capability declarations, JSON Schema 2020-12 conversion
Do NOT use this skill when
- Project imports from
@modelcontextprotocol/server/@modelcontextprotocol/client/@modelcontextprotocol/node(split packages) → usebuild-mcp-server-sdk-v2 - Handlers receive
(args, ctx)withctx.mcpReq.log()/ctx.http?.authInfo(v2ServerContext) → usebuild-mcp-server-sdk-v2 - Goal is porting an existing v1 server to v2 (not new build, not v1 maintenance) → use
convert-mcp-server-sdk-v1-to-v2 - Project depends on the
mcp-usewrapper library, not the raw SDK → usebuild-mcp-use-server
More from yigitkonur/skills-by-yigitkonur
run-research
Use skill if you are answering one technical research question with current web evidence, Reddit practitioner experience, and source-backed synthesis, optionally fanned out across parallel subagents.
42run-agent-browser
Use skill if you are driving the agent-browser CLI for ad hoc browser automation — @ref snapshots, sessions, forms, extraction, screenshots, headed/stealth, or provider runs.
38publish-npm-package
Use skill if you are publishing to npm via GitHub Actions release workflow with trusted publishing, NPM_TOKEN, provenance, semantic-release, changesets, release-please, or fixing npm publish CI.
35init-agent-config
Use skill if you are creating, auditing, or migrating CLAUDE.md, AGENTS.md, or REVIEW.md instruction files, folder-scoped agent guidance, or cross-agent companion entrypoints.
34build-mcp-use-server
Use skill if you are building TypeScript MCP servers with mcp-use/server — server.tool, response helpers, ctx.auth, sessions, transports, widgets, Inspector, deploy.
34build-skills
Use skill if you are creating or substantially revising a Claude skill and need workspace-first evidence, remote comparison, and repo-fit synthesis before writing SKILL.md.
32