ContextStore Python SDK

Talk to your ContextStore company brain — compiled memory + agent team — from Python. The SDK is a typed client over your backend's MCP JSON-RPC layer.

Install

pip install contextstore-sdk

Quickstart

import os
from contextstore import ContextStore

client = ContextStore(api_key=os.environ["CONTEXTSTORE_KEY"])

# Remember something
client.memory.add(
    content="Board approved usage-based pricing on Sep 12",
    metadata={"project": "pricing", "owner": "maya"},
)

# Ask the company brain — with sources
res = client.memory.query("What did we decide about pricing?")
print(res.answer)
print(res.sources)

Local / self-hosted

Point at your own backend (default is the hosted one):

client = ContextStore(
    api_key=os.environ["CONTEXTSTORE_KEY"],
    base_url="https://contextstore.onrender.com",
)

For local development you can pass a JWT instead of an api_key:

client = ContextStore(token="<jwt>")

Namespaces / methods

Scopes & API keys

Each API key carries a set of scopes that limit which tools it may call. Pick the smallest set your app needs:

Required scope per namespace:

A key with admin scope satisfies every tool. Requests authenticated with a user JWT (instead of an API key) are not scope-limited.

Errors

• AuthenticationError — bad/expired/scoped-out API key
• ApiError — the MCP tool returned an error
• ContextStoreError — network / transport issues

No external dependencies — uses only the Python standard library.