Python SDK

pip install theauth
# with DPoP support
pip install "theauth[dpop]"

from theauth import TheAuthClient, TheAuthSyncClient

# async
async with TheAuthClient(base_url="https://api.myapp.com/api/theauth", token="kv_...") as client:
    agents = await client.agents.list()

# sync
with TheAuthSyncClient(base_url="https://api.myapp.com/api/theauth", token="kv_...") as client:
    agents = client.agents.list()

from theauth.types import RegisterMcpServerInput

server = await client.mcp.register(
    RegisterMcpServerInput(
        name="github-mcp",
        endpoint="https://mcp.github.com",
        tools=["read_file", "list_repos"],
        rate_limit_rpm=60,
    )
)
found = await client.mcp.get(server.id)  # None when it does not exist

from theauth import ValidationError

try:
    result = await client.request(
        "POST", "/auth/team/invite", json={"email": "a@b.c"}
    )
except ValidationError as err:
    print(err.issues)

from theauth import TheAuthSyncClient
from theauth.dpop import DPoPAuth

auth = DPoPAuth()
jkt = auth.thumbprint()  # bind your access token to this value

with TheAuthSyncClient(base_url=BASE, token=access_token, auth=auth) as client:
    client.agents.list()