Agent Setup

Connect an Agent to TokST Cloud MCP for durable memory, shared context, and knowledge governance. Cloud MCP is the standard memory path. The CLI is an optional device tool for local endpoint connections, task execution, and diagnostics.

Connect Cloud MCP

Configure an OAuth-capable MCP client with the public endpoint:

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp"
    }
  }
}

The client opens TokST in a browser for approval. After approval, the Agent can use the complete Cloud MCP toolset for memory, context, knowledge bases, workspace governance, files, and account status.

Clients that use static MCP configuration can authenticate with a dedicated API key. Create one in Dashboard API Keys, store it in the client's protected configuration, and revoke it when the client no longer needs access.

{
  "mcpServers": {
    "tokst": {
      "type": "streamable-http",
      "url": "https://api.tokst.com/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_api_key"
      }
    }
  }
}

Add the TokST Skill

Copy this message into an Agent that supports Skills:

Read https://tokst.com/skill.md. Connect to TokST Cloud MCP at
https://api.tokst.com/mcp, complete authorization, search relevant context before
substantial work, and save only confirmed long-term information.

The Skill defines when to search, write, update, archive, and protect sensitive information. It keeps normal chat, Session capture, explicit tasks, and durable memory in their separate workflows.

Advanced: Connect Local Agent Endpoints

Use the optional device tool when you want TokST to observe supported local sessions or execute Dashboard-assigned tasks on this computer.

tokst start --agent all
tokst status
tokst doctor

start detects supported endpoint integrations and installs TokST-managed bridges. status reports current endpoint health, model, queue, and task state. doctor reports connection and configuration problems with recovery actions.

Verify the Connection

1. Open the MCP client and confirm that TokST tools are available.
2. Ask the Agent to search existing context before a substantive task.
3. Ask it to save one confirmed, durable fact or decision through TokST MCP.
4. Open Memories to confirm the result.

Use Cloud MCP for tool details, the Skill guide for Agent behavior, and CLI reference for device operations.

Troubleshooting