Python SDK¶

Build distributed MCP agents with Python decorators and zero boilerplate

Overview¶

The MCP Mesh Python SDK provides a decorator-based API for building distributed agent systems. Combined with FastMCP, you get:

• @mesh.tool - Register capabilities with dependency injection
• @mesh.agent - Configure agent servers with auto-run
• @mesh.llm - LLM-powered tools with automatic tool discovery
• @mesh.llm_provider - Zero-code LLM providers via LiteLLM
• @mesh.route - FastAPI routes with mesh DI

Installation¶

# Install the SDK
pip install mcp-mesh

# Install the CLI (required for development)
npm install -g @mcpmesh/cli

Quick Start¶

# View the quick start guide
meshctl man quickstart

# Or scaffold a new agent
meshctl scaffold --name my-agent

Documentation¶

For comprehensive documentation, use the built-in man pages:

meshctl man --list              # List all topics
meshctl man <topic>             # View a topic
meshctl man <topic> --raw       # Get markdown output (LLM-friendly)

Key Topics¶

Next Steps¶