Tools Reference
Every tool available through Titan AI Connect, organized by category.
Knowledge Tools
titan_lessonsSearch Titan Network training content and lessons.
community_feedSearch community discussions and member insights.
fetch_frameworkGet teaching frameworks. Slugs: plog (Product Launch Optimization), ppc_3_0 (PPC 3.0 tactics), states_and_drivers (posture matrix).
Seller Management
list_seller_accountsList linked Amazon stores in the active Titan Tools account.
set_active_sellerActivate a store by name; pass marketplace if duplicate names.
Account Data
Requires an active seller and a date range.get_account_performance_summaryRevenue, orders, units, margins, CM1/CM2/CM3.
get_account_ppc_metricsPPC totals: spend, sales, ACoS, ROAS.
get_account_ppc_metrics_by_campaignPPC by campaign. Filters: campaignIds, asins, adType. Response includes matchType, tags, outOfBudget, avgDailySpend per campaign (2026-05).
get_marketplacesConnected Amazon marketplaces.
get_brandsSeller brands.
Product Data
Requires an active seller.search_for_productsSearch by name, ASIN, or SKU.
get_products_summaryFull product list with metrics (paginated, needs dates).
get_product_performance_summaryMetrics for specific ASINs (needs dates).
get_product_ppc_metricsPPC data by product (needs dates).
PPC Metrics
Requires an active seller and a date range.get_ppc_portfolios_metricsPerformance by portfolio.
get_ppc_product_ads_metricsPerformance by product ad.
get_ppc_targets_metricsPerformance by keyword/target.
get_ppc_placements_metricsPerformance by placement (SP only). Server-side filter: asins (2026-05; narrows per-placement metrics).
get_ppc_search_terms_metricsPerformance by search term (SP only). Server-side filters: campaignIds, asins (both 2026-05).
get_ppc_ams_metricsHour-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_metricsBrand Analytics Search Query Performance by (ASIN, ISO week). Data horizon 2026-W15+; SP-only.
PPC Structure
Requires an active seller.search_for_ppc_campaignsFind 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_portfoliosList portfolios.
get_ppc_ad_groupsList ad groups.
get_ppc_product_adsList product ads.
get_ppc_targetsList keywords/targets.
get_ppc_negative_keywordsList negative keywords.
get_ppc_negative_targetsList 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_historyPPC modification audit trail.
Keyword Research & Audit
Requires an active seller. Mufasa-backed; first call may take up to 30 seconds.get_keyword_ranksDaily organic-rank tracker for an ASIN's tracked phrases (current rank + 8-week history). Mirrors the Titan Tools Keyword Rank Tracker.
get_keyword_relevancyKeywords Relevancy table for an ASIN. Use FIRST for relevance questions; do not infer relevance from PPC search-terms metrics.
get_keyword_tracker_dataTracker config for an ASIN: tracked phrases, tags, segments, labels, and member-authored comments.
get_ppc_auditLatest 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_portfolioMediumCreate SP portfolios.
propose_update_sp_portfolioMediumUpdate SP portfolios.
propose_create_sp_campaignHIGHCreate SP campaigns.
propose_update_sp_campaignConditionalPause, update budget, update name, or update schedule.
propose_create_sp_campaign_neg_keywordLowAdd campaign-level negative keywords.
propose_create_sp_ad_groupMediumCreate SP ad groups.
propose_update_sp_ad_groupConditionalPause, change default bid, or change name.
propose_create_sp_keywordHIGHAdd keywords.
propose_update_sp_keywordConditionalPause or change bid.
propose_create_sp_ad_group_neg_keywordLowAdd ad-group-level negative keywords.
propose_create_sp_targetMediumAdd product/category targets.
propose_update_sp_targetMediumUpdate targets (state, bid) — ASIN/category only; keywords go through propose_update_sp_keyword.
propose_create_sp_product_adHIGHCreate new product ads.
propose_update_sp_product_adConditionalPause or change state.
propose_update_sb_campaignMediumUpdate Sponsored Brands campaigns.
propose_update_sb_ad_groupConditionalUpdate Sponsored Brands ad groups.
propose_update_sb_adConditionalUpdate Sponsored Brands ads.
propose_update_sb_keywordConditionalUpdate Sponsored Brands keywords.
propose_update_sb_targetConditionalUpdate Sponsored Brands targets (requires targetId, adGroupId, and campaignId).
propose_create_sb_ad_group_neg_keywordLowAdd Sponsored Brands ad-group-level negative keywords.
propose_update_sp_campaign_neg_keywordLowPause, un-pause, or archive existing campaign-level negative keywords. State-only update.
propose_update_sp_ad_group_neg_keywordLowPause, un-pause, or archive existing ad-group-level negative keywords. State-only update.
propose_update_sb_ad_group_neg_keywordLowPause, 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_targetMediumAdd campaign-level negative targets — block competitor ASINs or brands.
propose_update_sp_campaign_neg_targetLowPause, un-pause, or archive existing campaign-level negative targets. State-only update.
propose_create_sp_ad_group_neg_targetMediumAdd ad-group-level negative targets — block competitor ASINs or brands at the ad-group level.
propose_update_sp_ad_group_neg_targetLowPause, un-pause, or archive existing ad-group-level negative targets. State-only update.
propose_create_sb_ad_group_neg_targetMediumAdd Sponsored Brands ad-group-level negative targets. CamelCase expression types (asinSameAs / asinBrandSameAs); body uses `expressions` (plural, NOT `expression`).
propose_update_sb_ad_group_neg_targetLowPause, un-pause, or archive existing Sponsored Brands ad-group negative targets. Lowercase state values; each item must include targetId and adGroupId.
propose_update_sd_campaignMediumUpdate Sponsored Display campaigns.
propose_update_sd_ad_groupConditionalUpdate Sponsored Display ad groups.
propose_update_sd_product_adConditionalUpdate Sponsored Display product ads.
propose_update_sd_targetConditionalUpdate Sponsored Display targets.
get_sp_bid_recommendationsRead-onlyGet Amazon's suggested bids (no writes).
Key Metrics
Ad spend / Ad sales— Lower is better
Ad sales / Ad spend— Higher is better
Ad spend / Total sales— Shows organic vs paid balance
Revenue - COGS - Amazon fees
CM1 - PPC spend - Refunds
CM2 - Other expenses
Orders / Sessions
Units / Sessions