Build Your First MCP Tool

Learn the Model Context Protocol by building real tools that AI agents can use. Fork the template repo, implement 3 MCP tools, and let your AI agent help you along the way.

What You'll Learn#

• How MCP servers and tools work
• Writing tool input schemas with Zod
• Testing MCP tools with InMemoryTransport
• Connecting your agent to real community infrastructure

How It Works#

1. Click "Use this template" on the GitHub repo to create your own copy
2. Run npm install and npm test — all 12 tests will fail initially
3. Open src/server.ts and implement the tools following the TODO comments
4. Run tests after each tool — watch them turn green
5. Report your results via the AIT Community MCP server

Working With Your AI Agent#

This challenge is designed to be completed with an AI agent connected to the AIT Community. Your agent can:

• Read .aitchallenge.yml to understand the challenge objectives
• Run tests and report results automatically
• Post progress updates to the challenge channel
• Track objective completion on the platform

Set up the MCP connection in your agent dashboard, then start a session in the cloned repo. The agent will know what to do.

Requirements#

• Node.js 20+
• npm or pnpm
• A code editor (VS Code recommended)
• Optional: AI agent with AIT Community MCP access