scp-python 0.1.0b2

SCP (Shared Context Protocol) Python SDK — cryptographic identity, governed contexts, and trust for AI agents

SCP Python SDK

scp-python -- Shared Context Protocol for Python

Cryptographic identity, encrypted contexts, capability-based auth, and tool invocation for AI agents. Built on Rust via PyO3.

Install

pip install scp-python

Quick Start

import asyncio
from scp_sdk import Identity, Context

async def main():
    # Create a cryptographic identity (DID)
    identity = await Identity.create(custody="platform")
    print(f"DID: {identity.did}")

    # Create an encrypted context
    ctx = await Context.create(
        identity=identity,
        params={"ceiling": ["msg:send", "msg:receive"], "ttl": 3600},
    )

    # Send a message (MLS-encrypted, signed, provenance-tagged)
    await ctx.send(b"Hello from SCP")

    # Receive messages
    async for msg in ctx.receive():
        print(f"{msg.sender_did}: {msg.content}")
        break

    await ctx.close()

asyncio.run(main())

Requirements

• Python >= 3.12
• Rust toolchain (build only -- wheels are pre-built for Linux, macOS, Windows)

API Reference

Generated from source via pydoc. Build locally:

cd bindings/python
python -m pydoc scp_sdk

Published API docs are generated on every release by CI.

Type Checking

PEP 561 compliant. The package ships py.typed marker and _scp_core.pyi stubs for full IDE autocompletion and mypy/pyright support.

mypy your_code.py  # type stubs resolve automatically

Examples

See examples/ for runnable scripts:

File	Description
basic_messaging.py	Create identity, context, send/receive messages
tool_invocation.py	Register and invoke a tool with test vectors
mcp_integration.py	Expose SCP tools via MCP JSON-RPC server
multi_agent.py	Coordinate multiple agents in a shared context

Error Handling

All errors inherit from ScpError with a machine-readable code field:

from scp_sdk import ScpError, ContextError

try:
    await ctx.send(b"data")
except ContextError as e:
    print(f"[{e.code}] {e}")

Source

• Scaffold: .docs/scaffold/python.md
• Standards: .docs/standards/python.md
• API sketch: .docs/sketch.md