Managing Accounts

Titan AI Connect lets a single user link multiple Titan Tools accounts and switch between them inside chat. Each account can hold multiple Amazon seller stores. The tools your AI uses to manage them are below.

Two-layer model

Don't confuse Titan Tools accounts with Amazon sellers. They are two different layers — and different tools manage each:

Titan AI Connect User (you)
  └─ Titan Tools Account (OAuth grant)        ← list_accounts / switch_account
      └─ Amazon Seller (store)                ← list_seller_accounts / set_active_seller
          └─ Products, PPC, performance       ← data tools

Why you might want this

Agencies — manage clients across multiple Titan Tools logins from a single Titan AI Connect / Claude account.
Multi-login sellers — separate Amazon entities (LLCs, regions, brands) you keep under different Titan Tools logins.
Personal + work — link both, switch between them in one chat without re-authenticating.

Linking a new account

The flow uses a polling pattern that works for both local agents (Claude Code on your machine) and remote agents (Claude.ai running in the cloud).

Ask your AI: "link a new Titan Tools account".
The agent calls link_account and shares an authUrl with you.
Open the URL in your browser. Sign in to Titan Tools and approve consent.
You land on a Titan AI Connect success page that displays a short completion code with a copy button.
If your browser is on the same machine as the agent: tell the agent "done". It calls complete_link({ linkSessionId }).
If you're on a different browser (e.g. you used the Claude.ai custom connector on your phone): copy the completion code, paste it back into chat, and the agent calls complete_link({ completionCode }).
Once linked, ask the agent to switch_account to it.

The default account rule

The first Titan Tools account you ever link becomes your default (isPrimary: true). It cannot be deleted.

If you delete the currently-active account, Titan AI Connect auto-switches your session back to the default. To "replace" the default, you currently have to link a new one and delete the others — full replacement is on our roadmap.

Tool reference

Tool	Purpose
list_accounts	List every Titan Tools account linked to your Titan AI Connect user.
switch_account	Activate one. Refreshes the seller list from Nexus and resets the active seller.
get_active_account	Return the currently-active account and seller in one call.
link_account	Start OAuth to add a new account. Returns authUrl + linkSessionId.
complete_link	Finalize a link_account flow. Pass linkSessionId or completionCode.
delete_account	Remove a non-default account. Auto-switches to default if it was active.

Common errors

Symptom	What to do
Account tools not visible	You're using a `tk_*` API key. Switch to Claude.ai or Claude Code (OAuth login).
Cannot delete default account	This is by design. Default (`isPrimary`) accounts are protected.
Data tool fails after switch_account	Switching resets the active seller. Re-run `list_seller_accounts` → `set_active_seller`.
complete_link returns "expired"	Link sessions are valid for 10 minutes. Ask the agent to call `link_account` again.