TikTok MCP Server

Instructions

Implementation Reference

• tiktok_mcp/server.py:286-310 (handler)

  The handler logic for the 'tiktok_session' tool within the server.py file.

  elif name == "tiktok_session":
      action = arguments["action"]
      if action == "check_login":
          logged_in = await browser.check_login()
          cookies_path = browser.cookies_path
          return [TextContent(type="text", text=json.dumps({
              "authenticated": logged_in,
              "cookies_path": cookies_path,
          }, indent=2))]
      elif action == "refresh_cookies":
          saved = await browser.save_cookies()
          return [TextContent(type="text", text=json.dumps({
              "cookies_refreshed": saved,
              "cookies_path": browser.cookies_path,
          }, indent=2))]
      elif action == "export_session":
          if browser._context:
              cookies = await browser._context.cookies()
              return [TextContent(type="text", text=json.dumps({
                  "cookie_count": len(cookies),
                  "domains": list(set(c.get("domain", "") for c in cookies)),
                  "session_keys": [c["name"] for c in cookies if "session" in c["name"].lower() or "sid" in c["name"].lower()],
              }, indent=2))]
          return [TextContent(type="text", text='{"error": "No active session"}')]

• tiktok_mcp/server.py:176-190 (registration)

  The tool registration definition for 'tiktok_session'.

  Tool(
      name="tiktok_session",
      description="Manage TikTok session: check login status, refresh cookies, export session info.",
      inputSchema={
          "type": "object",
          "properties": {
              "action": {
                  "type": "string",
                  "enum": ["check_login", "refresh_cookies", "export_session"],
                  "description": "Session management action",
              },
          },
          "required": ["action"],
      },
  ),