SDK Usage

This guide is the entry point for building an extension package on top of mpt-extension-sdk. Topic-specific examples live in smaller documents under sdk_usage/.

Usage Topics

Application setup: install the SDK, shape an extension package, create ExtensionApp, include routers, and configure the runtime.
Event routes: register task and non-task event handlers.
Schedule routes: register periodic work, read the schedule delivery, and follow the delivery protocol the Extension Framework drives.
Authenticated API routes: expose authenticated endpoints, validate bodies, read request/auth context, return API responses, and use pagination.
UI plugs: register PlugRouter providers, group plugs under nested navigation containers, declare modal (open-by-id) plugs, and reference static assets.
Contexts and pipelines: adapt execution contexts, compose pipelines, drive the step lifecycle and flow control, use pipeline hooks, and declare status transitions.
Immutable snapshots: treat MPT models as immutable, update parameters with the with_* helpers, and refresh after a write.
Error handling: raise typed step/pipeline errors and let the SDK map them to event responses.
Settings: the runtime, extension, and account settings layers and the environment-variable helpers.
Observability: SDK tracing, the azure-monitor extra, and extension-defined spans with trace_span.
CLI and metadata: the mpt-ext commands and meta.yaml generation/validation.
Marketplace services: use ctx.mpt_api_service from handlers and pipeline steps.

Runtime Commands

An extension built on the SDK is run through the packaged mpt-ext CLI. The commands and their contract are documented in CLI and metadata.

Metadata

Release files for mpt-extension-sdk 6.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mpt-extension-sdk 6.7.0
File	Size	Uploaded
mpt_extension_sdk-6.7.0.tar.gz	65.3 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mpt-extension-sdk 6.7.0
File	Interpreter	ABI	Platform	Reset
mpt_extension_sdk-6.7.0-py3-none-any.whl 111.7 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 177.0 kB

Release files / mpt_extension_sdk-6.7.0.tar.gz

Download URL	mpt_extension_sdk-6.7.0.tar.gz
Size	65.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`6b3ca2710c2c63578f2a4e60fbb81230cb8a5125380ee3937aa6a11932a2d21a`
BLAKE2b-256 checksum How to use checksums	`aed0686dab02b295ce32e44b9a4205aab1041f774d37c407bf51adcbed99e3d9`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.7.22`

Release files / mpt_extension_sdk-6.7.0-py3-none-any.whl

Download URL	mpt_extension_sdk-6.7.0-py3-none-any.whl
Size	111.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b8ea5ba60b595042ff79db774a0d7c2f9c4cb09834b2b7665dcaf222ada6e031`
BLAKE2b-256 checksum How to use checksums	`3e3551e551ccc9d9eb87327ab7019adbed527a423c638fe5093f9b9e4c31c85a`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.7.22`