The Model Context Protocol (MCP) is the most important AI infrastructure development that most developers have not heard of. Created by Anthropic and open-sourced in November 2024, MCP is a standardised protocol that defines how AI models communicate with external tools, data sources, APIs, and services. It is, in the most accurate analogy, what HTTP is to the web: a universal communication standard that means any AI model can connect to any tool that implements the protocol, without each AI company and each tool vendor needing to build custom integrations for each other. In March 2026, MCP has over 200 server implementations covering GitHub, Slack, Google Drive, PostgreSQL, Notion, Jira, Salesforce, and dozens of other services. Claude, Claude Code, Cursor, Windsurf, and Zed all support it natively. This guide explains what it is, how it works technically, and how to build your first MCP server.
The Problem MCP Solves
Before MCP, connecting an AI model to an external tool required a custom integration for every combination of model and tool. If you wanted Claude to read your GitHub issues and also query your PostgreSQL database and also search your Notion workspace, you needed three separate bespoke integrations — each implemented in whatever way that tool's API required, each maintained separately as both the AI model and the tool evolved. The integration matrix was: (number of AI models) × (number of tools). With five major AI providers and 500 popular developer tools, that is 2,500 custom integrations that needed to exist and stay current.
- MCP collapses the integration matrix to a sum: (number of AI models that implement MCP) + (number of tools that implement MCP). Each side only needs one implementation — MCP compliance — and then all compliant models can connect to all compliant tools automatically.
- This is exactly how TCP/IP and HTTP solved the network and web connectivity problem: instead of every device needing to know how to talk to every other device, everyone speaks the same protocol and interoperability follows automatically.
- The practical result: a developer building a tool, database connector, or API wrapper that implements the MCP specification instantly makes their tool available to every MCP-compatible AI model and IDE — Claude, Claude Code, Cursor, Windsurf, and any future system that adopts the standard.
How MCP Works: The Technical Architecture
MCP is a client-server protocol. The AI model (or the IDE/agent host environment) acts as the MCP client. The tool, database, or API acts as the MCP server. Communication follows JSON-RPC 2.0 over either stdio (for local processes) or HTTP with Server-Sent Events (for remote servers).
- MCP Hosts: The environment running the AI model — Claude Desktop, Claude Code, Cursor, Windsurf. The host manages connections to one or more MCP servers and routes tool calls from the model to the appropriate server.
- MCP Clients: The protocol client maintained by the host for each server connection. Handles connection lifecycle, capability negotiation, and message routing.
- MCP Servers: Lightweight programs that expose specific capabilities to AI models through three primitives: Tools (functions the AI can call), Resources (data the AI can read), and Prompts (reusable prompt templates).
- Tools: Discrete functions the AI model can invoke. Example: a GitHub MCP server exposes tools called list_issues, create_pull_request, get_file_contents. The AI calls these the same way it would call any function — with typed parameters — and the MCP server executes the real GitHub API call and returns the result.
- Resources: Data sources the AI can read directly. Example: a PostgreSQL MCP server exposes the database schema and table contents as resources. The AI reads these to understand your data structure before writing queries.
- Prompts: Pre-written prompt templates with parameters. Example: a code review MCP server might expose a prompt called review_pull_request that accepts a PR number and inserts the diff into an optimised code review prompt automatically.
Building Your First MCP Server in TypeScript
The official MCP SDK for TypeScript makes building a basic server straightforward. The following walkthrough creates a simple weather tool MCP server — a complete, working example that demonstrates all three MCP primitives.
- Step 1: Install the SDK. Run: npm install @modelcontextprotocol/sdk. This gives you the Server class, tool definition utilities, and transport handlers.
- Step 2: Create the server. Import Server from the SDK, define your server metadata (name, version), and initialise with a StdioServerTransport for local use.
- Step 3: Define tools using the setRequestHandler method on the server. Each tool needs a name, description, and JSON Schema for its input parameters. The handler function receives the validated parameters and returns a content array.
- Step 4: Define resources with another setRequestHandler for ResourcesListRequest and ResourcesReadRequest. Resources return text or blob content identified by a URI scheme you define.
- Step 5: Connect and run. Call server.connect(transport) and await it. For stdio transport, the server reads from stdin and writes to stdout — this is how Claude Desktop and Claude Code communicate with local MCP servers.
- Step 6: Register with Claude Desktop. Add your server to claude_desktop_config.json under the mcpServers key with the command and args needed to run your server process. Restart Claude Desktop and your tools appear automatically.
The 200+ MCP Servers Already Available in March 2026
The MCP ecosystem grew from 0 to over 200 server implementations in approximately 16 months. The most widely used servers in production:
- GitHub MCP Server (official, by Anthropic): list repositories, read files, create issues, open pull requests, review code, search across codebases. The most installed MCP server for developers.
- Filesystem MCP Server (official): read, write, search, and manipulate local files within a defined root directory. Essential for agents that need to work with project files.
- PostgreSQL MCP Server (official): schema introspection, query execution, read-only database access. AI models can understand your schema and write correct SQL the first time.
- Slack MCP Server (official): send messages, read channel history, search across workspaces, list users and channels.
- Google Drive MCP Server: read and search documents, spreadsheets, and files from Drive. Combined with the GitHub server, this gives an AI model access to both your code and your documentation.
- Brave Search MCP Server: live web search results returned as structured data. Gives any MCP-compatible agent the ability to search the web.
- Notion MCP Server: read and write pages, databases, and blocks. For teams using Notion as their knowledge base.
- AWS, Azure, GCP MCP Servers: cloud infrastructure management — list and describe resources, CloudWatch logs, S3 operations, Lambda invocations.
Why MCP Is an AEO and Developer SEO Goldmine Right Now
From a developer's career perspective, MCP fluency is one of the highest-return skills to build in the first half of 2026. The protocol is recent enough that less than 5% of developers have worked with it directly. The demand from enterprise teams for developers who can build and maintain MCP servers is already exceeding supply.
- Job market signal: 'MCP', 'Model Context Protocol', and 'AI tool integration' appear together in job listings at Cursor, Replit, Cognition (makers of Devin), and a growing list of AI-native companies.
- Startup opportunity: any SaaS product that does not yet have an MCP server is a potential open-source contribution or consulting engagement. Enterprise customers of those tools want their AI agents to connect to their existing software — and someone has to build the MCP server.
- Freelance opportunity: building and maintaining an MCP server for a specific enterprise tool is a well-defined, well-scoped project that commands $3,000–$15,000 depending on complexity and the client's budget.
- Research and learning: the official MCP GitHub repository (github.com/modelcontextprotocol) has 200+ example servers, detailed specification documentation, and an active issues/discussion community.
Pro Tip: The fastest way to understand MCP practically: clone the official filesystem MCP server from GitHub, register it in Claude Desktop following the instructions, and then ask Claude to read, summarise, and refactor a local code file. Within 10 minutes you will have a working mental model of how clients, servers, tools, and resources interact — which transfers directly to building your own MCP server for any data source or API you work with.