Tools Reference

Every tool available through Titan AI Connect, organized by category.

Looking for account management tools (link, switch, list)? They're documented in detail at Managing Accounts.

Knowledge Tools

titan_lessons

Search Titan Network training content and lessons.

community_feed

Search community discussions and member insights.

fetch_framework

Get teaching frameworks. Slugs: plog (Product Launch Optimization), ppc_3_0 (PPC 3.0 tactics), states_and_drivers (posture matrix).

Seller Management

list_seller_accounts

List linked Amazon stores in the active Titan Tools account.

set_active_seller

Activate a store by name; pass marketplace if duplicate names.

Account Data

Requires an active seller and a date range.
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. Filters: campaignIds, asins, adType. Response includes matchType, tags, outOfBudget, avgDailySpend per campaign (2026-05).

get_marketplaces

Connected Amazon marketplaces.

get_brands

Seller brands.

Product Data

Requires an 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 an active seller and a date range.
get_ppc_portfolios_metrics

Performance by portfolio.

get_ppc_product_ads_metrics

Performance by product ad.

get_ppc_targets_metrics

Performance by keyword/target.

get_ppc_placements_metrics

Performance by placement (SP only). Server-side filter: asins (2026-05; narrows per-placement metrics).

get_ppc_search_terms_metrics

Performance by search term (SP only). Server-side filters: campaignIds, asins (both 2026-05).

get_ppc_ams_metrics

Hour-of-day or weekday breakdown of whole-account PPC (Amazon Marketing Stream — SP+SB+SD, SP=7d/SB+SD=14d attribution, bucketed by conversion hour). Available for all regions where the seller is subscribed to AMS via Amazon Ads. Required: groupBy ('hour' or 'day'). Server-side filters: campaignIds, portfolioIds, asins (AND across fields — intersection; OR within array). Near-real-time — endDate can be today (no 2-day lag). Hours in the seller's account-level local timezone (US→PT, DE→CET, UK→GMT/BST). Currency: pass any ISO code; conversion server-side via daily mid-rate at UTC midnight. ⚠ All-zero ≠ no ads — most often deliberate operator dayparting, NOT budget exhaustion; ask the operator before recommending changes; cross-verify with get_account_ppc_metrics.

get_sqp_metrics

Brand Analytics Search Query Performance by (ASIN, ISO week). Data horizon 2026-W15+; SP-only.

PPC Structure

Requires an active seller.
search_for_ppc_campaigns

Find campaigns by name. Each response item carries a state field — filter client-side for enabled/paused/archived (upstream rejects a status request param with 400 as of 2026-05-15). Response includes matchType + tags per campaign (2026-05).

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_negative_targets

List existing negative targets (Live API). Required scope: 'sp_campaign' / 'sp_ad_group' / 'sb_ad_group'. Use before pause/archive flows so you have real targetIds.

get_ppc_change_history

PPC modification audit trail.

Keyword Research & Audit

Requires an active seller. Mufasa-backed; first call may take up to 30 seconds.
get_keyword_ranks

Daily organic-rank tracker for an ASIN's tracked phrases (current rank + 8-week history). Mirrors the Titan Tools Keyword Rank Tracker.

get_keyword_relevancy

Keywords Relevancy table for an ASIN. Use FIRST for relevance questions; do not infer relevance from PPC search-terms metrics.

get_keyword_tracker_data

Tracker config for an ASIN: tracked phrases, tags, segments, labels, and member-authored comments.

get_ppc_audit

Latest completed PPC Audit metadata + a 5-minute presigned download URL. Click to download the xlsx; the audit data is not inline.

Actions

Approval-gated by your AI host. Read the safety guide before enabling.
propose_create_sp_portfolioMedium

Create SP portfolios.

propose_update_sp_portfolioMedium

Update SP portfolios.

propose_create_sp_campaignHIGH

Create SP campaigns.

propose_update_sp_campaignConditional

Pause, update budget, update name, or update schedule.

propose_create_sp_campaign_neg_keywordLow

Add campaign-level negative keywords.

propose_create_sp_ad_groupMedium

Create SP ad groups.

propose_update_sp_ad_groupConditional

Pause, change default bid, or change name.

propose_create_sp_keywordHIGH

Add keywords.

propose_update_sp_keywordConditional

Pause or change bid.

propose_create_sp_ad_group_neg_keywordLow

Add ad-group-level negative keywords.

propose_create_sp_targetMedium

Add product/category targets.

propose_update_sp_targetMedium

Update targets (state, bid) — ASIN/category only; keywords go through propose_update_sp_keyword.

propose_create_sp_product_adHIGH

Create new product ads.

propose_update_sp_product_adConditional

Pause or change state.

propose_update_sb_campaignMedium

Update Sponsored Brands campaigns.

propose_update_sb_ad_groupConditional

Update Sponsored Brands ad groups.

propose_update_sb_adConditional

Update Sponsored Brands ads.

propose_update_sb_keywordConditional

Update Sponsored Brands keywords.

propose_update_sb_targetConditional

Update Sponsored Brands targets (requires targetId, adGroupId, and campaignId).

propose_create_sb_ad_group_neg_keywordLow

Add Sponsored Brands ad-group-level negative keywords.

propose_update_sp_campaign_neg_keywordLow

Pause, un-pause, or archive existing campaign-level negative keywords. State-only update.

propose_update_sp_ad_group_neg_keywordLow

Pause, un-pause, or archive existing ad-group-level negative keywords. State-only update.

propose_update_sb_ad_group_neg_keywordLow

Pause, un-pause, or archive existing Sponsored Brands ad-group negative keywords. Lowercase state values; each item must include keywordId, adGroupId, and campaignId.

propose_create_sp_campaign_neg_targetMedium

Add campaign-level negative targets — block competitor ASINs or brands.

propose_update_sp_campaign_neg_targetLow

Pause, un-pause, or archive existing campaign-level negative targets. State-only update.

propose_create_sp_ad_group_neg_targetMedium

Add ad-group-level negative targets — block competitor ASINs or brands at the ad-group level.

propose_update_sp_ad_group_neg_targetLow

Pause, un-pause, or archive existing ad-group-level negative targets. State-only update.

propose_create_sb_ad_group_neg_targetMedium

Add Sponsored Brands ad-group-level negative targets. CamelCase expression types (asinSameAs / asinBrandSameAs); body uses `expressions` (plural, NOT `expression`).

propose_update_sb_ad_group_neg_targetLow

Pause, un-pause, or archive existing Sponsored Brands ad-group negative targets. Lowercase state values; each item must include targetId and adGroupId.

propose_update_sd_campaignMedium

Update Sponsored Display campaigns.

propose_update_sd_ad_groupConditional

Update Sponsored Display ad groups.

propose_update_sd_product_adConditional

Update Sponsored Display product ads.

propose_update_sd_targetConditional

Update Sponsored Display targets.

get_sp_bid_recommendationsRead-only

Get Amazon's suggested bids (no writes).

Key Metrics

ACoS(Advertising Cost of Sales)

Ad spend / Ad salesLower is better

ROAS(Return on Ad Spend)

Ad sales / Ad spendHigher is better

TACoS(Total ACoS)

Ad spend / Total salesShows 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