User GuidesOverview

User Guides

Step-by-step tutorials for building with MA²D.

Getting Started with Guides

These guides walk you through practical, real-world scenarios for using MA²D. Each guide is hands-on and includes complete examples you can follow.

Available Guides

🚀 For Beginners

Coming soon:

  • Creating Your First Server - Build a complete MCP server from scratch
  • Testing MCP Endpoints - Learn how to test with cURL and Postman
  • Adding Mock Scenarios - Create realistic mock responses

🎨 Intermediate

Coming soon:

  • Agent Card Basics - Create your first Agent Card
  • Design Rules & Compliance - Ensure compliance

🚢 Advanced

Coming soon:

  • Publishing to Exchange - Share your work
  • Real-World Examples - Complete production examples

Learning Path

Quick Start Guide Selection

I want to…

…create my first MCP server
→ Start with Getting Started

…test if my server works
→ See Quick Start Guide

…add realistic test data
→ Learn about MCP Servers

…build an Agent Card
→ Check Features

…ensure my design is compliant
→ Understanding coming soon

…share my work publicly
→ Publishing guide coming soon

Prerequisites for All Guides

Before starting any guide, make sure you have:

  • ✅ Completed Getting Started
  • ✅ MA²D running locally or hosted instance access
  • ✅ Basic understanding of REST APIs
  • ✅ Familiarity with JSON

Let’s build something awesome! 🚀

Note: Detailed step-by-step guides are being added. In the meantime, check out the Getting Started section for comprehensive tutorials.