---
title: "Python SDK reference"
description: "Start with the small package-root surface for ordinary synchronous tests:"
---

> M3 v0.2.16 · commit 796f6943274f075d973f267794444b91ba208010.


# Python SDK reference

Start with the small package-root surface for ordinary synchronous tests:

```python
from m3 import MCPTestKit, StdioServer, expect
```

Use focused modules for the rest of the supported contract:

| Need | Reference |
| --- | --- |
| Core kit, direct operations, and agent sessions | [Core execution](https://m3.sineframe.com/docs/reference/python/m3/core.md) |
| Server, result, policy, and operation values | [Types](https://m3.sineframe.com/docs/reference/python/m3/types.md) |
| Execution assertions | [Matchers](https://m3.sineframe.com/docs/reference/python/m3/matchers.md) |
| Typed traces | [Observability](https://m3.sineframe.com/docs/reference/python/m3/observability.md) |
| Evaluators and aggregation | [Evaluations](https://m3.sineframe.com/docs/reference/python/m3/evaluations.md) |
| Elicitation and managed input | [Elicitation](https://m3.sineframe.com/docs/reference/python/m3/elicitation.md) |
| Matrix cases | [Matrices](https://m3.sineframe.com/docs/reference/python/m3/matrix.md) |
| Test doubles and snapshots | [Testing utilities](https://m3.sineframe.com/docs/reference/python/m3/testing.md) |
| Persistent and in-memory stores | [Storage](https://m3.sineframe.com/docs/reference/python/m3/storage.md) |
| Exceptions | [Errors](https://m3.sineframe.com/docs/reference/python/m3/errors.md) |

Each page explains ownership, inputs, results, and failure behavior. Exact
signatures are checked against the release's public export contract.

Use the [Python API inventory](https://m3.sineframe.com/docs/reference/python/api.md) for exact signatures,
model fields, and public methods across every declared module.