ctxd 0.1.9

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 --api-key ... validates and stores an API key in the OS credential store for future CLI and SDK usage
5. ctxd login without --api-key validates and stores CTXD_API_KEY, validates an existing secure-store key, or prompts for an API key when neither is available
6. If the OS credential store is unavailable, use CTXD_API_KEY for CI/headless usage or explicitly set CTXD_CREDENTIAL_STORE=encrypted-file to store the API key in an encrypted local file

Base URL resolution order:

1. base_url= passed to the client
2. CTXD_BASE_URL
3. ~/.ctxd/config.json
4. https://mcp.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")