chio-sdk

Stable Python SDK for Chio hosted MCP sessions, receipt queries, and invariant verification.

Installation

pip install chio-sdk

The distribution name is chio-sdk. The import package is chio.

Quickstart

from chio import ChioClient, ReceiptQueryClient

client = ChioClient.with_static_bearer("http://127.0.0.1:8931", "demo-token")
session = client.initialize()

try:
    tools = session.list_tools()
    print(tools)

    receipts = ReceiptQueryClient("http://127.0.0.1:8940", "demo-token").query(
        {"toolServer": "wrapped-http-mock", "limit": 5}
    )
    print(receipts["totalCount"])
finally:
    session.close()

API Reference

• ChioClient initializes authenticated Chio MCP HTTP sessions.
• ChioSession exposes typed helpers for tools, resources, prompts, logging, tasks, and explicit JSON-RPC envelopes.
• ReceiptQueryClient wraps GET /v1/receipts/query with typed parameters and pagination helpers.
• chio.invariants provides canonical JSON, hashing, signing, capability, receipt, and manifest verification helpers.

The full public reference lives in docs/reference/SDK_PYTHON_REFERENCE.md.

Official Example

The package-local governed example expects a running Chio hosted edge and trust service:

CHIO_BASE_URL=http://127.0.0.1:8931 \
CHIO_CONTROL_URL=http://127.0.0.1:8940 \
CHIO_AUTH_TOKEN=demo-token \
python packages/sdk/chio-py/examples/governed_hello.py

For a repo-local end-to-end verification run that boots those services automatically, use:

./scripts/check-sdk-publication-examples.sh

Canonical Example Links

• ../../../docs/guides/WEB_BACKEND_QUICKSTART.md
• ../../../examples/hello-openapi-sidecar/README.md
• ../../../examples/hello-fastapi/README.md

Release Checks

./scripts/check-chio-py.sh
./scripts/check-chio-py-release.sh

Release process details live in RELEASING.md.