Quick Start
TokST gives an Agent durable knowledge through Cloud MCP. The shortest setup has three steps. The standalone CLI Runtime is optional and is only needed for connected devices, Agent execution, automatic Sessions, Tasks, and Communication.
1. Connect Cloud MCP
Add the public Streamable HTTP endpoint to your MCP client:
{
"mcpServers": {
"tokst": {
"type": "streamable-http",
"url": "https://api.tokst.com/mcp"
}
}
}
Static clients without browser OAuth can create a dedicated key in Dashboard API Keys and send it as a Bearer token. Keep each key in the client's protected credential store.
2. Complete Authorization
Open the authorization page presented by the MCP client, sign in to TokST, and approve the requested access. Reconnect the client after approval. The Agent then receives the complete Cloud MCP toolset for Memories, search, context, Atlases, Workspaces, and files.
If the client cannot open browser authorization, use the API-key configuration from the MCP reference.
3. Use Memory
Ask the Agent to save confirmed knowledge as Markdown:
Save this confirmed decision as a TokST decision memory in Markdown:
# Production release approval
- Production releases require approval from the Workspace owner.
- This policy applies to every production deployment.
The Agent uses tokst_remember. It can use tokst_search for a specific historical question, tokst_context for a grouped knowledge snapshot, and tokst_memory_get when an ID is already known.
Store confirmed facts, decisions, preferences, rules, architecture, and reusable notes. Keep credentials, private keys, raw reasoning, full logs, and temporary tool output outside durable Memory.
Agent Skill
Agents that support Skills can read the MCP-only operating guide:
Read https://tokst.com/skill.md and use TokST Cloud MCP at https://api.tokst.com/mcp for durable Markdown memory, search, context, and knowledge governance.
The Skill keeps searches purposeful, writes complete, and lifecycle changes traceable. It does not require the CLI.
Product Objects
| Object | Purpose | Created when |
|---|---|---|
| Memory | Durable facts, decisions, preferences, architecture, and notes | A user or Agent explicitly saves reusable knowledge |
| Session | Automatic capture, compilation, and diagnostics for normal Agent use | Automatic Memory is enabled for a supported local client |
| Task | Assigned work with execution steps, results, and history | A user explicitly creates and assigns a Task |
| Communication | Long-lived direct chats and Agent groups with streaming replies | A user opens a contact or creates a group |
These objects keep separate histories and can link to one another without being created implicitly.
Optional CLI Runtime
Install the standalone Runtime only when this device should connect local Agents, execute Tasks, capture Sessions, or participate in Communication.
macOS and Linux:
curl -fsSLo tokst-install.sh https://tokst.com/install.sh && sh tokst-install.sh
tokst login
tokst start
tokst status
Windows PowerShell:
Invoke-WebRequest https://tokst.com/install.ps1 -OutFile "$env:TEMP\tokst-install.ps1"
& "$env:TEMP\tokst-install.ps1"
tokst login
tokst start
tokst status
Automatic Memory is off by default. Enable only the supported clients you want to capture with tokst auto on --agent <name>.
Next Steps
- Read the MCP reference for all 32 tools.
- Read Memory Management for durable record quality.
- Read Communication for direct chats, groups, delivery, and streaming replies.
- Read Sessions and Tasks for advanced Runtime workflows.
- Read the CLI reference for device and Agent diagnostics.