ctxd 0.1.4

Public Python SDK and CLI for the ctxd platform.

ctxd

Public Python SDK and CLI for the ctxd platform.

Install:

pip install ctxd

The SDK exposes sync and async clients:

• Client
• AsyncClient

Authentication:

1. Preferred for headless and scripts: create a user-bound API key through the authenticated application backend
2. Provide it with Client(api_key=...) or CTXD_API_KEY
3. The SDK sends that key as the bearer token directly to the MCP server
4. ctxd login is still supported for interactive local OAuth login

Base URL resolution order:

1. base_url= passed to the client
2. CTXD_BASE_URL
3. ~/.ctxd/config.json
4. https://mcp.ctxd.dev

Auth API URL resolution order:

1. CTXD_AUTH_API_URL
2. https://api.ctxd.dev

Example:

from ctxd import Client

client = Client(api_key="297e24c4-4ee9-4739-828f-48f57f48ce11")

results = client.search("text:deployment application:slack")
profile = client.get_profile()
document = client.fetch_document("doc-123")

API key example:

from ctxd import Client

client = Client(api_key="297e24c4-4ee9-4739-828f-48f57f48ce11")
results = client.search("text:deployment application:slack")

Async example:

from ctxd import AsyncClient

async with AsyncClient(api_key="297e24c4-4ee9-4739-828f-48f57f48ce11") as client:
    results = await client.search("text:deployment")