Tools Reference

Complete reference for all 28 Amazon seller tools available through TitanConnect.

Account Management

OAuth-authenticated MCP only — invisible to tk_* API keys

list_accounts

List all Titan Tools accounts linked to your TitanConnect user

switch_account

Activate one — refreshes seller list from that account, resets active seller

get_active_account

Return the currently-active Titan Tools account + seller

link_account

Start OAuth to add a new Titan Tools account; returns authUrl + linkSessionId

complete_link

Finalize a link_account flow with linkSessionId or completionCode

delete_account

Remove a non-default Titan Tools account (default cannot be deleted)

Seller Management

Always available

list_seller_accounts

List linked Amazon stores (in the active Titan Tools account, if any)

set_active_seller

Activate a store by name; pass marketplace if duplicate names

Knowledge Tools

Always available, no seller needed

titan_lessons

Search Titan Network training content and lessons

community_feed

Search community discussions and member insights

whatsapp_conversations

Search WhatsApp group discussions for real-time tips

fetch_framework

Get teaching frameworks (e.g., PLOG for Product Launch Optimization Guide)

Account Data

Requires active seller + dates + currencyCode

get_account_performance_summary

Revenue, orders, units, margins, CM1/CM2/CM3

get_account_ppc_metrics

PPC totals: spend, sales, ACoS, ROAS

get_account_ppc_metrics_by_campaign

PPC by campaign (paginated)

get_marketplaces

Connected Amazon marketplaces

get_brands

Seller brands

Product Data

Requires active seller

search_for_products

Search by name, ASIN, or SKU

get_products_summary

Full product list with metrics (paginated, needs dates)

get_product_performance_summary

Metrics for specific ASINs (needs dates)

get_product_ppc_metrics

PPC data by product (needs dates)

PPC Metrics

Requires active seller + dates + currencyCode

get_ppc_portfolios_metrics

By portfolio

get_ppc_product_ads_metrics

By product ad

get_ppc_targets_metrics

By keyword/target

get_ppc_placements_metrics

By placement (SP only)

get_ppc_search_terms_metrics

By search term (SP only)

PPC Structure

Requires active seller, no dates needed

search_for_ppc_campaigns

Find campaigns by name/status

get_ppc_portfolios

List portfolios

get_ppc_ad_groups

List ad groups

get_ppc_product_ads

List product ads

get_ppc_targets

List keywords/targets

get_ppc_negative_keywords

List negative keywords

get_ppc_change_history

PPC modification audit trail

Actions (Amazon Ads Writes)

OAuth tools:write scope required. Default dry-run mode. See /docs/actions for the safety guide.

propose_create_sp_portfolio

Risk: Medium. Create SP portfolios

propose_update_sp_portfolio

Risk: Medium. Update SP portfolios

propose_create_sp_campaign

Risk: HIGH. Create SP campaigns (NEW SPEND)

propose_update_sp_campaign

Risk: Conditional. Pause / change budget / change bidding

propose_create_sp_campaign_neg_keyword

Risk: Low. Add campaign-level negative keywords

propose_create_sp_ad_group

Risk: Medium. Create SP ad groups

propose_create_sp_keyword

Risk: HIGH. Add keywords (NEW SPEND)

propose_create_sp_ad_group_neg_keyword

Risk: Low. Add ad-group-level negative keywords

propose_create_sp_target

Risk: Medium. Add product/category targets

propose_update_sp_target

Risk: Medium. Update targets (state, bid)

propose_create_sp_product_ad

Risk: HIGH. Create new product ads (NEW SPEND)

propose_update_sb_campaign

Risk: Medium. Update Sponsored Brands campaigns

propose_update_sd_campaign

Risk: Medium. Update Sponsored Display campaigns

get_sp_bid_recommendations

Read-only. Get suggested bids (no writes)

Key Metrics

ACoS(Advertising Cost of Sales)

Ad spend / Ad sales— Lower is better

ROAS(Return on Ad Spend)

Ad sales / Ad spend— Higher is better

TACoS(Total ACoS)

Ad spend / Total sales— Shows organic vs paid balance

CM1(Contribution Margin 1)

Revenue - COGS - Amazon fees

CM2(Contribution Margin 2)

CM1 - PPC spend - Refunds

CM3(Contribution Margin 3)

CM2 - Other expenses

CVR(Conversion Rate)

Orders / Sessions

Unit Session %(Unit Session Percentage)

Units / Sessions