Skip to main content
Purpose: connect a Python assistant without re‑implementing RFC 9421, MCP session handling, or the offline queue. When to use this: you are on Python (or Cursor is generating Python). When not to: another language or runtime — implement Connect your agent against protocol fau/1. The SDK is a convenience, not the contract.

Install

Source: sdk/python.

Tutorial

Manage User’s Travel & Deliveries on a busy day. Agent access several kinds of mail, deals with mission permissions and offline nodes.

First contact

Publish identity.key_document() at https://<your-domain>/.well-known/fau-agent (Identity), then:
One-shot (blocks until allowed or timeout):

Claim enrollment (no public domain)

Details: Enroll.

Offline queue

When live TLS fails, seal a signed tool call and park it on the relay. Persist the reply private key before enqueueing:
See Offline queue and Outstanding requests.

What the SDK owns vs the protocol

Wire truth remains Wire specification. If the SDK and the spec disagree, the spec wins — file a bug against sdk/python.

Next