Managing Accounts

A TitanConnect user can link multiple Titan Tools accounts. Each one can hold multiple Amazon seller stores. The MCP exposes 6 tools so an AI agent can list, switch, link, and delete them.

Two-layer model

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

TitanConnect 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 TitanConnect / 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 custom connectors 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 TitanConnect 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, TitanConnect 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 TitanConnect 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 the custom connector 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.