SDK Reference¶

Complete reference documentation for the Model Context Protocol Language (MPL) ecosystem. This section covers the SDK libraries, CLI tooling, configuration options, and API endpoints.

Available References¶

Python SDK¶

Full reference for the MPL Python SDK, covering SType definitions, schema validation, QoM profiling, proxy integration, and more.

Pages: 8
Install: pip install mpl-sdk
Async model: asyncio / async-await
Schema engine: jsonschema

Python SDK Reference

TypeScript SDK¶

Full reference for the MPL TypeScript SDK, covering SType definitions, schema validation, QoM profiling, proxy integration, and more.

Pages: 8
Install: npm install @mpl/sdk
Async model: Promise / async-await
Schema engine: AJV

TypeScript SDK Reference

CLI Reference¶

Complete command reference for the mpl binary. Covers proxy management, schema operations, validation, QoM evaluation, and conformance testing.

CLI Reference

Configuration Reference¶

Full reference for mpl-config.yaml including transport settings, MPL enforcement options, observability configuration, and environment variable overrides.

Configuration Reference

REST API Reference¶

Documentation for all HTTP endpoints exposed by the MPL proxy (port 9443) and the optional registry API service.

REST API Reference

Quick Comparison¶

Feature	Python SDK	TypeScript SDK
Language	Python 3.9+	TypeScript 5.0+ / Node 18+
Install command	`pip install mpl-sdk`	`npm install @mpl/sdk`
Async model	asyncio / async-await	Promise / async-await
Schema validation engine	jsonschema	AJV
SType definition	Dataclass / Pydantic	Interface / AJV schema
QoM profiling	Built-in	Built-in
Proxy integration	`MplProxyClient`	`MplProxyClient`
Registry support	Read / Write	Read / Write
Streaming	AsyncIterator	AsyncGenerator
IC assertions	Decorator-based	Middleware-based

Architecture Overview¶

┌─────────────────────────────────────────────────────┐
│                  Your Application                    │
│         (Python SDK  or  TypeScript SDK)             │
└───────────────────────┬─────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────┐
│                MPL Proxy (mpl binary)                │
│  Port 9443 (proxy)  │  Port 9100 (metrics)          │
│  ─────────────────────────────────────────────────  │
│  • Schema validation   • QoM enforcement            │
│  • IC assertions       • Policy engine              │
│  • Traffic learning    • Observability              │
└───────────────────────┬─────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────┐
│            MCP / A2A Server (upstream)               │
└─────────────────────────────────────────────────────┘

Getting Started¶

If you are new to MPL, start with:

Getting Started Guide - Installation and first steps
Concepts - Core concepts (STypes, QoM, IC)
This Reference - Detailed API and configuration documentation