ClueState

DEVELOPERS

01 / API & SDKS · OFFICIAL INTEGRATION INTERFACES

Integrate in minutes. Keep control of the state model.

ClueState provides ergonomic, zero-dependency SDKs for TypeScript and Python, standard REST endpoints with Bearer auth, and a Model Context Protocol (MCP) server for native AI tool calling.

TypeScript SDK Python SDK REST API MCP Server Docker Compose

TYPESCRIPT & JAVASCRIPT SDK · @cluestate/sdk

Zero Dependencies. Universal Fetch.

Works seamlessly across Node.js 18+, Bun, Deno, Cloudflare Workers, Next.js, and browser runtimes.

npm install @cluestate/sdk
TypeScript

import
{ ClueState }
from
'@cluestate/sdk'
;
const
cs =
new
ClueState({
apiKey: process.env.CLUESTATE_API_KEY!,
// cs_live_...
baseUrl: process.env.CLUESTATE_API_URL ||
'https://app.cluestate.com'
,
});
// Ingest interaction with explicit idempotency key
const
result =
await
cs.ingest({
externalId:
'cust_402'
,
entityName:
'Marcus Vance'
,
content:
'We migrated from MySQL to PostgreSQL. Q4 budget is $25,000.'
,
sourceType:
'support_ticket'
,
sourceRecordId:
'ticket_8841'
,
idempotencyKey:
'evt_ticket_8841'
,
});
// Query current maintained entity intelligence
const
intel =
await
cs.getIntel({ externalId:
'cust_402'
});
console.log(intel.memories);
// Array of typed, active Memory objects

PYTHON SDK · cluestate-sdk

Pydantic Models. Async & Sync Clients.

Lightweight client depending only on httpx and pydantic. Ideal for FastAPI backends, LangChain, and agent runtimes.

pip install cluestate-sdk
Python 3.11+

from
cluestate_sdk
import
ClueState
client = ClueState(
api_key=
"cs_live_YOUR_API_KEY"
,
base_url=
"https://app.cluestate.com"
,
)
Ingest interaction
result = client.ingest(
external_id=
"cust_402"
,
entity_name=
"Marcus Vance"
,
source_type=
"support_ticket"
,
content=
"Our approved software budget for Q4 is $25,000."
,
)
Fetch entity state and prompt representation
intel = client.get_intel(external_id=
"cust_402"
)
print(intel.formatted_prompt)

REST API

cURL / HTTP Endpoints

Authenticate using Bearer tokens generated from the ClueState dashboard:

curl -X POST https://app.cluestate.com/api/ingest \
-H "Authorization: Bearer cs_live_..." \
-H "Content-Type: application/json" \
-d '{"external_id": "cust_402", "content": "..."}'

MODEL CONTEXT PROTOCOL

MCP Server Setup

Configure ClueState in Claude Desktop, Cursor, or Antigravity MCP settings:

{
"mcpServers": {
"cluestate": {
"command": "uvx",
"args": ["cluestate", "mcp"],
"env": { "CLUESTATE_API_KEY": "cs_live_..." }
}
}
}

SELF-HOSTING · DOCKER COMPOSE

Run the Complete Stack in 2 Commands

Clone the repository, configure your environment file, and launch ClueState with PostgreSQL, migration runner, and management UI under Apache 2.0.

git clone https://github.com/cluestate/cluestate.git
cd cluestate
cp .env.example .env
docker-compose up -d