scxp 0.1.0

Symmetric Context Exchange Protocol (SCXP) SDK for Python: consumer + provider surface, handshake, id correlation/dispatch, and Gen A tool-schema generation. Transport-agnostic.

scxp

Python SDK for the Symmetric Context Exchange Protocol (SCXP) — a protocol for exchanging tool catalogs and tool calls between a consumer (which discovers and invokes tools) and a provider (which registers and serves them).

The SDK is transport-agnostic: you bring the transport (WebSocket, TCP, stdio, ...) by implementing a small Channel, and the SDK handles the protocol — handshake, id correlation, batching, and tool-schema generation.

Install

pip install scxp

Requires Python 3.11+.

Provider — expose tools

from scxp import Provider, ProviderCatalog, tool, Info

class Tools:
    @tool(name="add", domain="com.example.math", description="Add two integers.")
    def add(self, a: int, b: int) -> int:
        return a + b

catalog = ProviderCatalog.from_object(Tools(), Info(name="my-provider", version="1.0.0"))

# `channel` is your Channel implementation, already connected.
provider = await Provider.create(channel, catalog)
# The provider now serves tools/list and tools/call.

Consumer — discover and invoke tools

from scxp import Consumer, ConsumerConfig, Info

# `channel` is your Channel implementation, already connected.
consumer = await Consumer.create(
    channel, ConsumerConfig(info=Info(name="my-app", version="1.0.0"))
)

manifest = await consumer.list_tools()          # discover
result = await consumer.call_tool("add", {"a": 2, "b": 3})   # invoke
print(result.content[0].text)  # "5"

Bring your own transport

Implement Channel (send bytes, receive bytes, observe close). A runnable WebSocket example lives under examples/.

from scxp import Channel  # a typing.Protocol with: send / on_message / on_close

Docs

• Consumer and provider integration guides: docs/
• Protocol spec and JSON Schemas: the SCXP repository

License

MIT.