1. Docs
2. /
3. Tool reference
4. /
5. Agents & Machines
6. /
7. tagSession

Agents & Machines

tagSession

Tag Session

Add tags to or remove tags from one of YOUR agent sessions: the exact mirror of tagPage, applied to a dispatched run instead of a page.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "tag this run", and it calls tagSession.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "conversationId": "<conversationId>"
  },
  "name": "tagSession"
}

Arguments

• addstring[]optionalTags to add: lowercase letters, digits, hyphen, or underscore; a leading # is stripped.
• conversationIdstringrequiredThe agent session to tag: its conversationId (from listAgentSessions or runAgent).
• removestring[]optionalTags to remove from the session.

Returns

Returns the session's resulting tags.

Ask for it

The Cloud routes these requests to this verb.

• tag this run
• label that agent session
• add the #X tag to the run
• remove the Y tag from the session

Pair it with

The verbs that finish the job.

• listAgentSessions
• getAgentResult

Questions

• What does tagSession do?

  Add tags to or remove tags from one of YOUR agent sessions: the exact mirror of tagPage, applied to a dispatched run instead of a page. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use tagSession from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "tag this run", and it calls tagSession.

• Is tagSession safe to let an AI call?

  tagSession changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.