--- title: How to Build Your First MCP Server (2026 Guide) | daily.dev description: A practical guide to building your first MCP (Model Context Protocol) server, covering the full workflow from transport selection (stdio vs HTTP) to tool... canonical: https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: How to Build Your First MCP Server (2026 Guide) | daily.dev og:description: A practical guide to building your first MCP (Model Context Protocol) server, covering the full workflow from transport selection (stdio vs HTTP) to tool... og:url: https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru og:image: https://api.daily.dev/og/posts/Rumt2nTRU.png og:image:alt: How to Build Your First MCP Server (2026 Guide) og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # How to Build Your First MCP Server (2026 Guide) **[Alex CloudStar](https://daily.dev/sources/alexcloudstar)** · [@alexcloudstar](https://daily.dev/alexcloudstar) · 17 min read · 2 upvotes · 1 comments ## Summary A practical guide to building your first MCP (Model Context Protocol) server, covering the full workflow from transport selection (stdio vs HTTP) to tool design principles, auth, testing, and integration with Claude Code. Includes a minimal working TypeScript example and six hard-won lessons: write tool descriptions before implementations, log every call, cap response sizes, version from day one, and treat the server like a product. Key design rules: match tools to user intentions not implementation details, return only what the model needs to decide next, make errors educational, and favor idempotency. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### Should I use stdio or streamable HTTP transport for my first MCP server? Stdio transport is recommended for a first MCP server because it has the fastest feedback loop, no auth requirements, and the simplest deployment story since the agent runtime spawns the server as a child process and pipes JSON-RPC over stdin/stdout. Streamable HTTP is better once the server needs to be shared across machines or requires centralized auth. The older SSE-only transport is deprecated and should not be used for new servers. _Anyone deciding between transports for a new MCP server can compare tradeoffs like these on daily.dev._ ### How many tools should an MCP server expose to work well with an AI agent? Fewer, broader tools work better than many narrow ones; a server refactored from twenty-five tools down to eight saw more actual usage, because the model has to read every tool description on every call and too many tools drown the signal in noise. Tools should map to user intentions, like a single natural-language search_tickets tool, rather than mirroring implementation details with many narrow filter functions. _Developers designing agent-facing tool sets can find practical patterns like this on daily.dev._ ### How do I test an MCP server without relying on the AI model during development? Test the server like a normal HTTP API before ever connecting a model: first use an inspector tool such as npx @modelcontextprotocol/inspector to send raw JSON-RPC calls and check responses, then write integration tests directly against the tool handler functions, and only afterward wire it into an agent like Claude Code to observe whether the model discovers and uses tools sensibly. This order catches most bugs without burning any model tokens. _Developers building reliable MCP tooling can track workflow tips like this on daily.dev._ ## Community discussion Top comments from developers on daily.dev. **@agustinbarrientos** · 0 upvotes > Did usage improve because the eight tools were broader, or because their descriptions got better too? ## Similar posts on daily.dev - [Building MCP Servers: Custom Context for Claude Code](https://daily.dev/posts/building-mcp-servers-custom-context-for-claude-code-iarhgi53v) · SitePoint · 1 upvotes · 0 comments - [How to Build MCP Servers for Your Internal Data](https://daily.dev/posts/how-to-build-mcp-servers-for-your-internal-data-mal9z290q) · freeCodeCamp · 3 upvotes · 0 comments - [Build Your First MCP Server in C\#: A Step-by-Step Quickstart](https://daily.dev/posts/build-your-first-mcp-server-in-c-a-step-by-step-quickstart-pt500c6tu) · We Are .NET · 4 upvotes · 0 comments - [MCP servers turn Claude into a reasoning engine for your data](https://daily.dev/posts/mcp-servers-turn-claude-into-a-reasoning-engine-for-your-data-gxpgn4shj) · The New Stack · 0 upvotes · 0 comments --- Tags: [#ai-agents](https://daily.dev/tags/ai-agents), [#typescript](https://daily.dev/tags/typescript), [#mcp](https://daily.dev/tags/mcp), [#claude-code](https://daily.dev/tags/claude-code) [View this post on daily.dev](https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"How to Build Your First MCP Server (2026 Guide)","url":"https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru"},"datePublished":"2026-07-09T07:49:50.508Z","dateModified":"2026-09-13T19:00:18.303Z","description":"A practical guide to building your first MCP (Model Context Protocol) server, covering the full workflow from transport selection (stdio vs HTTP) to tool...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/bd34eeee80952af46a12a8579be1ee48?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/bd34eeee80952af46a12a8579be1ee48?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Alex CloudStar","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Person","name":"Alex Cloudstar","url":"https://daily.dev/alexcloudstar","image":"https://media.daily.dev/image/upload/s--xA-1aKK7--/f_auto/v1767564650/avatars/avatar_ZUjetzkwG7V5behQOpH0X?_a=BAMAK+ZW0","description":"Hi there! 👋🏻 I'm a Senior Full-Stack Developer oriented on Javascript","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":990}},"commentCount":1,"discussionUrl":"https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":2},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":1}],"keywords":"ai-agents,typescript,mcp,claude-code","timeRequired":"PT17M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Alex CloudStar","item":"https://daily.dev/sources/alexcloudstar"},{"@type":"ListItem","position":3,"name":"How to Build Your First MCP Server (2026 Guide)"}]} {"@context":"https://schema.org","@type":"WebPage","@id":"https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru","comment":[{"@type":"Comment","text":"Did usage improve because the eight tools were broader, or because their descriptions got better too?","datePublished":"2026-08-01T20:24:24.323Z","url":"https://daily.dev/posts/Rumt2nTRU#c-jiRwCDd5T","author":{"@type":"Person","name":"Agustin Barrientos","url":"https://daily.dev/agustinbarrientos","image":"https://media.daily.dev/image/upload/s--5ayxQnqn--/f_auto/v1788281802/avatars/avatar_wQYYVe5Tbj0NJ7C7qPoa8?_a=BAMAMicg0"}}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/how-to-build-your-first-mcp-server-2026-guide--rumt2ntru#faq","mainEntity":[{"@type":"Question","name":"Should I use stdio or streamable HTTP transport for my first MCP server?","acceptedAnswer":{"@type":"Answer","text":"Stdio transport is recommended for a first MCP server because it has the fastest feedback loop, no auth requirements, and the simplest deployment story since the agent runtime spawns the server as a child process and pipes JSON-RPC over stdin/stdout. Streamable HTTP is better once the server needs to be shared across machines or requires centralized auth. The older SSE-only transport is deprecated and should not be used for new servers. Anyone deciding between transports for a new MCP server can compare tradeoffs like these on daily.dev."}},{"@type":"Question","name":"How many tools should an MCP server expose to work well with an AI agent?","acceptedAnswer":{"@type":"Answer","text":"Fewer, broader tools work better than many narrow ones; a server refactored from twenty-five tools down to eight saw more actual usage, because the model has to read every tool description on every call and too many tools drown the signal in noise. Tools should map to user intentions, like a single natural-language search_tickets tool, rather than mirroring implementation details with many narrow filter functions. Developers designing agent-facing tool sets can find practical patterns like this on daily.dev."}},{"@type":"Question","name":"How do I test an MCP server without relying on the AI model during development?","acceptedAnswer":{"@type":"Answer","text":"Test the server like a normal HTTP API before ever connecting a model: first use an inspector tool such as npx @modelcontextprotocol/inspector to send raw JSON-RPC calls and check responses, then write integration tests directly against the tool handler functions, and only afterward wire it into an agent like Claude Code to observe whether the model discovers and uses tools sensibly. This order catches most bugs without burning any model tokens. Developers building reliable MCP tooling can track workflow tips like this on daily.dev."}}]} ```