Servidor MCP

Sorsa

app.sorsa/sorsa
Comercio y retail Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este MCP

Supports Amazon FBA arbitrage with product analysis, sourcing and deal feeds, pricing alerts, inventory and order reporting, profitability, and account operations.

add_storefront_monitor
Start monitoring another Amazon seller's storefront — new products they list will appear in the user's store results. storefront_id is the Amazon seller ID (e.g. A1B2C3D4E5F6G7, found in the seller page URL). Call when the user says 'track this seller'.
Esquema de entrada
{'type': 'object', 'title': 'add_storefront_monitorArguments', 'required': ['storefront_id'], 'properties': {'storefront_id': {'type': 'string', 'title': 'Storefront Id'}}}
add_to_sourcing_list
Add a product to the user's sourcing list (their buy list). Call when the user says 'add this to my buy list' — typically after analysing a product, passing through the numbers from the analysis. sourced_from is where they'd buy it (retailer/site).
Esquema de entrada
{'type': 'object', 'title': 'add_to_sourcing_listArguments', 'required': ['title'], 'properties': {'roi': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Roi', 'default': None}, 'asin': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Asin', 'default': None}, 'cost': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Cost', 'default': None}, 'notes': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Notes', 'default': None}, 'title': {'type': 'string', 'title': 'Title'}, 'company': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Company', 'default': None}, 'sales_rank': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Sales Rank', 'default': None}, 'sourced_from': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sourced From', 'default': None}, 'monthly_sales': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Monthly Sales', 'default': None}, 'projected_profit': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Projected Profit', 'default': None}, 'projected_sale_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Projected Sale Price', 'default': None}}}
analyse_product
Quick analysis of an Amazon product by ASIN: title, brand, current/90-day pricing, sales rank and estimated monthly sales, FBA fees and profit basics. Call this first whenever the user asks about a specific ASIN. Costs the user 1 analyse credit unless cached. Domain is the Amazon marketplace: GB, US, DE, FR, ES or IT.
Esquema de entrada
{'type': 'object', 'title': 'analyse_productArguments', 'required': ['asin'], 'properties': {'asin': {'type': 'string', 'title': 'Asin'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
analyse_product_full
Full analysis of an Amazon product by ASIN — everything in analyse_product plus seller/stock breakdown, buy-box history and variations. Slower and heavier than analyse_product; use when the user wants seller-level or historical detail in one shot. Costs 1 analyse credit unless the ASIN was analysed in the last 24 hours.
Esquema de entrada
{'type': 'object', 'title': 'analyse_product_fullArguments', 'required': ['asin'], 'properties': {'asin': {'type': 'string', 'title': 'Asin'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
calculate_profit
Calculate Amazon FBA profit and ROI for given sell/cost prices using the full fee engine (tiered referral fees, digital services tax, VAT on fees). Call for what-if questions like 'what would I make selling at £24.99 if I buy at £12?'. Prices are in the marketplace currency.
Esquema de entrada
{'type': 'object', 'title': 'calculate_profitArguments', 'required': ['sell_price', 'cost_price'], 'properties': {'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}, 'category': {'type': 'string', 'title': 'Category', 'default': ''}, 'cost_price': {'type': 'number', 'title': 'Cost Price'}, 'sell_price': {'type': 'number', 'title': 'Sell Price'}, 'referral_fee_pct': {'type': 'number', 'title': 'Referral Fee Pct', 'default': 15}, 'pick_and_pack_fee': {'type': 'number', 'title': 'Pick And Pack Fee', 'default': 0}}}
check_eligibility
Check whether the user is allowed to sell (ungated for) one or more ASINs on their Amazon account. Call for 'am I ungated for this?' or 'can I sell these ASINs?'. Returns per-ASIN {state, gated, apply_link}. Uncached ASINs are queued for a fresh check, so re-call shortly for any still pending. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'check_eligibilityArguments', 'required': ['asins'], 'properties': {'asins': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Asins'}, 'condition': {'type': 'string', 'title': 'Condition', 'default': 'new_new'}}}
create_deal_task
Create an A2A deal-monitor task: the user gets notified whenever the deal feed finds products matching these filters. Call when the user says e.g. 'notify me about deals over £5 profit and 40% ROI in Toys'.
Esquema de entrada
{'type': 'object', 'title': 'create_deal_taskArguments', 'required': ['task_name'], 'properties': {'source': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source', 'default': None}, 'min_roi': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Roi', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'task_name': {'type': 'string', 'title': 'Task Name'}, 'min_profit': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Profit', 'default': None}, 'keepa_drops': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Keepa Drops', 'default': None}, 'max_asin_rank': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Max Asin Rank', 'default': None}, 'min_monthly_sales': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Monthly Sales', 'default': None}}}
create_price_monitor
Watch an ASIN and alert the user when its price drops to the target. Call when the user says things like 'watch this' or 'alert me if it goes below £20'. source is the marketplace: Amazon UK, Amazon DE, Amazon IT, Amazon ES, Amazon FR, Amazon US or Amazon Business UK.
Esquema de entrada
{'type': 'object', 'title': 'create_price_monitorArguments', 'required': ['asin', 'target_price'], 'properties': {'asin': {'type': 'string', 'title': 'Asin'}, 'source': {'type': 'string', 'title': 'Source', 'default': 'Amazon UK'}, 'target_price': {'type': 'number', 'title': 'Target Price'}}}
find_products
Search Amazon via Keepa's Product Finder and return the matching ASINs (up to 100). Runs on the USER'S OWN Keepa key — call get_keepa_key_status first; if not connected, tell them to add their key in Sorsa Settings. Provide at least one filter. Prices are in the marketplace's currency (e.g. £ for UK). marketplace: UK, US, DE, FR, IT, ES. Drop filters find items whose price fell by a % over a period — set any of drop_1d/7d/30d/90d (e.g. drop_30d=20 = 'dropped 20%+ in 30 days'), applied to drop_type: BUY_BOX_SHIPPING, AMAZON, or PRIME_EXCL. category is a Keepa root-category id (omit for all categories). Returns {count, asins[]} — analyse specific ones with analyse_product.
Esquema de entrada
{'type': 'object', 'title': 'find_productsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 0}, 'brand': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Brand', 'default': None}, 'drop_1d': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Drop 1D', 'default': None}, 'drop_7d': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Drop 7D', 'default': None}, 'max_bsr': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Max Bsr', 'default': None}, 'category': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'drop_30d': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Drop 30D', 'default': None}, 'drop_90d': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Drop 90D', 'default': None}, 'drop_type': {'type': 'string', 'title': 'Drop Type', 'default': 'BUY_BOX_SHIPPING'}, 'min_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Rating', 'default': None}, 'marketplace': {'type': 'string', 'title': 'Marketplace', 'default': 'UK'}, 'max_sellers': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Max Sellers', 'default': None}, 'min_reviews': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Reviews', 'default': None}, 'exclude_word': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Exclude Word', 'default': None}, 'max_prime_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Max Prime Price', 'default': None}, 'min_prime_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Prime Price', 'default': None}, 'max_amazon_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Max Amazon Price', 'default': None}, 'min_amazon_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Amazon Price', 'default': None}, 'min_monthly_sold': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Monthly Sold', 'default': None}, 'max_buy_box_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Max Buy Box Price', 'default': None}, 'min_buy_box_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Buy Box Price', 'default': None}, 'amazon_not_on_listing': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Amazon Not On Listing', 'default': None}}}
get_a2a_finder_jobs
List the user's recent A2A Finder scan jobs and their status. Call to find a job_id whose results to fetch.
Esquema de entrada
{'type': 'object', 'title': 'get_a2a_finder_jobsArguments', 'properties': {}}
get_a2a_finder_status
Status and results of an A2A Finder scan started with start_a2a_finder_scan. Returns progress % and, once complete, the profitable cross-marketplace flips found (per ASIN, per country).
Esquema de entrada
{'type': 'object', 'title': 'get_a2a_finder_statusArguments', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'title': 'Job Id'}}}
get_aged_stock
Age profile of the user's on-hand FBA stock, bucketed by days on shelf (0-30, 31-90, 91-180, 181-365, 365+), with capital tied up and how much is aged 90+ days (long-term storage-fee risk). Call for 'what stock is old or at risk?' or 'how much capital is stuck in aged inventory?'. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'get_aged_stockArguments', 'properties': {}}
get_amazon_inventory
The user's live FBA inventory: SKUs, quantities, conditions. Call when the user asks what stock they have or about a specific SKU/product they sell. Requires their Amazon account to be connected (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_amazon_inventoryArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'min_quantity': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Quantity', 'default': None}}}
get_amazon_orders
The user's Amazon orders with fees and COGS-based profit. Call for questions like 'how are sales today?' or 'show orders for this SKU'. timeframe: today, yesterday, week, month; or use date_from/date_to (YYYY-MM-DD). Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_amazon_ordersArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Status', 'default': None}, 'date_to': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Date To', 'default': None}, 'date_from': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Date From', 'default': None}, 'timeframe': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Timeframe', 'default': None}}}
get_analyse_history
The user's recent product analyses (ASIN, title, when). Call when the user asks what they looked at recently, or to re-find a product they mention having analysed. limit max 50.
Esquema de entrada
{'type': 'object', 'title': 'get_analyse_historyArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20}}}
get_best_sellers
The user's own top-selling ASINs by net profit for each of the last N months, derived from their sales. Call for 'what are my best sellers?' or 'top products this year'. months up to 24, top_n up to 50. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'get_best_sellersArguments', 'properties': {'top_n': {'type': 'integer', 'title': 'Top N', 'default': 10}, 'months': {'type': 'integer', 'title': 'Months', 'default': 12}}}
get_credits
The user's remaining monthly analyse and AI credits and the reset date. Call when the user asks about their usage limits, or after a credit-limit error from an analysis tool.
Esquema de entrada
{'type': 'object', 'title': 'get_creditsArguments', 'properties': {}}
get_dashboard_summary
The user's Sorsa dashboard summary — headline stats across their monitors and results. Call for a general 'how's it looking' overview before drilling into specific feeds.
Esquema de entrada
{'type': 'object', 'title': 'get_dashboard_summaryArguments', 'properties': {}}
get_deal_results
Search Sorsa's Amazon-to-Amazon (A2A) deal database — products found by the deal monitors with profit, ROI, sales rank and pricing. Call when the user asks for current deals, e.g. 'show me deals over £5 profit and 50% ROI'. Free to call. sort_field: timestamp, profit, roi_percentage, asin_rank or current_price.
Esquema de entrada
{'type': 'object', 'title': 'get_deal_resultsArguments', 'properties': {'asin': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Asin', 'default': None}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 50}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0}, 'source': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source', 'default': None}, 'min_roi': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Roi', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'max_rank': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Max Rank', 'default': None}, 'min_sales': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Sales', 'default': None}, 'min_profit': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Profit', 'default': None}, 'sort_field': {'type': 'string', 'title': 'Sort Field', 'default': 'timestamp'}, 'search_title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search Title', 'default': None}, 'sort_direction': {'type': 'string', 'title': 'Sort Direction', 'default': 'desc'}}}
get_deal_tasks
List the user's A2A deal-monitor tasks (saved filters that generate notifications). Call before creating one, or when the user asks what monitors they have set up.
Esquema de entrada
{'type': 'object', 'title': 'get_deal_tasksArguments', 'properties': {}}
get_fba_refunds
Refunds issued to the user's customers. Call when the user asks about refunds or money returned to buyers. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_fba_refundsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}}}
get_fba_reimbursements
Reimbursements Amazon has paid the user (lost/damaged stock etc). Call when the user asks what Amazon has paid them back. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_fba_reimbursementsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'reason': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Reason', 'default': None}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}}}
get_fba_returns
The user's FBA customer returns with dispositions (sellable, damaged, etc). Call when the user asks about returns. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_fba_returnsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'disposition': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Disposition', 'default': None}}}
get_fba_shipment_items
The line items inside one FBA shipment (expected vs received quantities). Call after get_fba_shipments when the user asks what was in a specific shipment or whether everything was received.
Esquema de entrada
{'type': 'object', 'title': 'get_fba_shipment_itemsArguments', 'required': ['shipment_id'], 'properties': {'shipment_id': {'type': 'string', 'title': 'Shipment Id'}}}
get_fba_shipments
The user's inbound FBA shipments with summary stats. Call when the user asks about shipments they've sent to Amazon. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_fba_shipmentsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Status', 'default': None}}}
get_international_prices
Prices for the same ASIN across international Amazon marketplaces. Call when the user asks about cross-market price differences or EU arbitrage opportunities for a product. Costs 1 analyse credit unless the ASIN was analysed in the last 24 hours.
Esquema de entrada
{'type': 'object', 'title': 'get_international_pricesArguments', 'required': ['asin'], 'properties': {'asin': {'type': 'string', 'title': 'Asin'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
get_items_purchased
Items the user has actually purchased from their sourcing list, including listing status (SKU, listing errors). Call when the user asks what they've bought or about listing progress.
Esquema de entrada
{'type': 'object', 'title': 'get_items_purchasedArguments', 'properties': {}}
get_items_sourced
The user's sourcing list — products they've found and are considering buying, with cost/profit projections and status. Call when the user asks about their buy list or sourcing pipeline.
Esquema de entrada
{'type': 'object', 'title': 'get_items_sourcedArguments', 'properties': {}}
get_keepa_key_status
Whether the user has connected their own Keepa API key (needed for find_products). If not connected, tell them to add it in Sorsa Settings. Never returns the key itself.
Esquema de entrada
{'type': 'object', 'title': 'get_keepa_key_statusArguments', 'properties': {}}
get_monthly_pnl
Per-SKU profit & loss for one calendar month: revenue, Amazon fees, COGS, refunds and net profit, plus account totals. Call for 'what was my profit in <month>?' or 'break down last month's P&L'. month is 'YYYY-MM'. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'get_monthly_pnlArguments', 'required': ['month'], 'properties': {'month': {'type': 'string', 'title': 'Month'}, 'vat_registered': {'type': 'boolean', 'title': 'Vat Registered', 'default': False}}}
get_notifications
The user's price-alert notifications from their A2A monitor tasks, grouped by task. Call when the user asks what alerts or notifications they have. show_checked: 'unchecked' (default), 'checked' or 'all'.
Esquema de entrada
{'type': 'object', 'title': 'get_notificationsArguments', 'properties': {'show_checked': {'type': 'string', 'title': 'Show Checked', 'default': 'unchecked'}}}
get_oa_deals
Profitable online-arbitrage (OA) deals: retail products matched to Amazon listings with profit and ROI. Call when the user asks about OA or retail sourcing opportunities. sort: roi, profit, price, newest, sell, rank, monthly_sold or sellers.
Esquema de entrada
{'type': 'object', 'title': 'get_oa_dealsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'sort': {'type': 'string', 'title': 'Sort', 'default': 'roi'}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'min_roi': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Roi', 'default': None}, 'max_rank': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Max Rank', 'default': None}, 'per_page': {'type': 'integer', 'title': 'Per Page', 'default': 25}, 'retailer': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Retailer', 'default': None}, 'min_profit': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Min Profit', 'default': None}, 'min_monthly_sold': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Min Monthly Sold', 'default': None}}}
get_oa_retailers
List the retailers available in the OA deals feed. Call to know which retailer names are valid filters for get_oa_deals.
Esquema de entrada
{'type': 'object', 'title': 'get_oa_retailersArguments', 'properties': {}}
get_price_monitors
List the user's ASIN price monitors (watched products with target prices). Call before creating one to avoid duplicates, or when the user asks what they're watching.
Esquema de entrada
{'type': 'object', 'title': 'get_price_monitorsArguments', 'properties': {}}
get_product_performance
Per-SKU profitability over the last N days: units, revenue, profit, ROI, return rate, current price vs break-even and a selling-at-a-loss flag. Call for 'which products make or lose me money?' or 'what's selling below break-even?'. days 7-365. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'get_product_performanceArguments', 'properties': {'days': {'type': 'integer', 'title': 'Days', 'default': 30}}}
get_product_sellers
Current sellers and their stock levels for an Amazon ASIN. Call when the user asks who is selling a product, how many sellers there are, or how much stock competitors hold. Costs 1 analyse credit unless the ASIN was analysed in the last 24 hours.
Esquema de entrada
{'type': 'object', 'title': 'get_product_sellersArguments', 'required': ['asin'], 'properties': {'asin': {'type': 'string', 'title': 'Asin'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
get_purchases
The user's logged purchase history. timeframe: all, day, week, month or year. Call when the user asks what they've bought recently.
Esquema de entrada
{'type': 'object', 'title': 'get_purchasesArguments', 'properties': {'timeframe': {'type': 'string', 'title': 'Timeframe', 'default': 'all'}}}
get_purchase_stats
Purchase statistics: total spent, projected profit, items bought and ROI, broken down daily/monthly/yearly and by category and source. Call for questions like 'how much have I spent this month?'.
Esquema de entrada
{'type': 'object', 'title': 'get_purchase_statsArguments', 'properties': {}}
get_reconciliation_claims
Individual reclaim opportunities with evidence — what to claim from Amazon and why. Call after get_reconciliation_summary to list the actual claims. status: open, dismissed, filed or all. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_reconciliation_claimsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 25}, 'status': {'type': 'string', 'title': 'Status', 'default': 'open'}, 'claim_type': {'type': 'string', 'title': 'Claim Type', 'default': 'all'}}}
get_reconciliation_summary
Totals of reclaimable money Sorsa has detected the user is owed by Amazon, broken down by claim type (shipment shortages, lost inventory, unreturned refunds...). Call for 'how much does Amazon owe me?'. Requires a connected Amazon account (closed beta).
Esquema de entrada
{'type': 'object', 'title': 'get_reconciliation_summaryArguments', 'properties': {}}
get_repricer_items
The user's repricer SKUs with live pricing state: current price, Buy Box price, lowest FBA price, cost/min/max, strategy, computed profit/ROI at the current price, floor price and stock. Call when the user asks what the repricer is doing, whether they hold the Buy Box on something, or why an item isn't repricing. search matches SKU or ASIN. status filters to one of: active, off, out_of_stock, needs_cog, needs_min, awaiting_fees, error, or 'attention' (needs_cog + needs_min + error). limit max 500. Read-only.
Esquema de entrada
{'type': 'object', 'title': 'get_repricer_itemsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 50}, 'search': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Search', 'default': None}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Status', 'default': None}}}
get_repricer_log
Recent repricer price changes, newest first: SKU, old → new price, the reason, the reference price it repriced against (Buy Box / lowest FBA) and whether the floor or ceiling capped the move. Call when the user asks what the repricer changed recently or why a price moved. limit max 500.
Esquema de entrada
{'type': 'object', 'title': 'get_repricer_logArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 50}}}
get_repricer_settings
The user's global repricer settings: whether repricing is globally enabled, seller ID, default strategy, default minimum ROI, allowed strategies and VAT registration. Read-only — changing settings is web-app only.
Esquema de entrada
{'type': 'object', 'title': 'get_repricer_settingsArguments', 'properties': {}}
get_repricer_stats
Repricer dashboard summary: total/active SKU counts, per-status breakdown, Buy Box wins and win %, items matching the Buy Box exactly, units actively repricing and the last update time. Call first for broad questions like 'how's the repricer doing?'.
Esquema de entrada
{'type': 'object', 'title': 'get_repricer_statsArguments', 'properties': {}}
get_restock_suggestions
What the user should reorder now. Per-SKU sales velocity vs stock on hand -> days of cover left, a suggested reorder quantity and its potential profit. Call for 'what should I restock?' or 'what's running low?'. lead_time_days = how long a resupply takes to land; cover_days = days of stock the reorder should provide. Requires a connected Amazon account.
Esquema de entrada
{'type': 'object', 'title': 'get_restock_suggestionsArguments', 'properties': {'cover_days': {'type': 'integer', 'title': 'Cover Days', 'default': 30}, 'lead_time_days': {'type': 'integer', 'title': 'Lead Time Days', 'default': 14}}}
get_reverse_source_jobs
List the user's recent Reverse Source scan jobs and their status. Call to find a job_id whose results to fetch.
Esquema de entrada
{'type': 'object', 'title': 'get_reverse_source_jobsArguments', 'properties': {}}
get_reverse_source_status
Status and results of a Reverse Source scan started with start_reverse_source_scan. Returns progress % and, once complete, the cheapest Google Shopping source found per ASIN (retailer, price, link).
Esquema de entrada
{'type': 'object', 'title': 'get_reverse_source_statusArguments', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'title': 'Job Id'}}}
get_storefront_monitors
List the Amazon storefronts (competitor sellers) the user is monitoring. Call before adding one, or when the user asks which storefronts they track.
Esquema de entrada
{'type': 'object', 'title': 'get_storefront_monitorsArguments', 'properties': {}}
get_storefront_stats
Summary stats for the user's storefront monitors (stores tracked, result counts). Call for an overview before drilling into get_store_results.
Esquema de entrada
{'type': 'object', 'title': 'get_storefront_statsArguments', 'properties': {}}
get_store_results
Products found by the user's storefront monitors (tracking other sellers' Amazon storefronts), newest first. Call when the user asks what their storefront monitors have found; optionally filter to one store_id. Paginated — 'total' in the response is the full count, request further pages for more. per_page max 200 (keep small: rows are wide).
Esquema de entrada
{'type': 'object', 'title': 'get_store_resultsArguments', 'properties': {'page': {'type': 'integer', 'title': 'Page', 'default': 1}, 'per_page': {'type': 'integer', 'title': 'Per Page', 'default': 25}, 'store_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Store Id', 'default': None}}}
get_wholesale_jobs
List the user's recent Wholesale Scanner jobs and their status. Call to find a job_id whose results to fetch.
Esquema de entrada
{'type': 'object', 'title': 'get_wholesale_jobsArguments', 'properties': {}}
get_wholesale_status
Status and results of a Wholesale Scanner run. Returns progress % and, once complete, each supplier product matched to Amazon with sell price, profit and ROI.
Esquema de entrada
{'type': 'object', 'title': 'get_wholesale_statusArguments', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'title': 'Job Id'}}}
lookup_by_ean
Resolve a barcode (EAN/UPC, 8-14 digits) to an Amazon ASIN. Call when the user gives a barcode instead of an ASIN, then feed the returned ASIN into analyse_product.
Esquema de entrada
{'type': 'object', 'title': 'lookup_by_eanArguments', 'required': ['code'], 'properties': {'code': {'type': 'string', 'title': 'Code'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
mark_notification
Mark one of the user's notifications as checked (reviewed) or unchecked. Call after the user says they've dealt with an alert, or to un-mark one.
Esquema de entrada
{'type': 'object', 'title': 'mark_notificationArguments', 'required': ['notification_id'], 'properties': {'checked': {'type': 'boolean', 'title': 'Checked', 'default': True}, 'notification_id': {'type': 'integer', 'title': 'Notification Id'}}}
search_by_title
Search Amazon by product title via Keepa and return the top matching ASINs with thumbnails. Call when the user names a product without an ASIN or barcode; present the candidates and let them pick before analysing. limit is 1-10.
Esquema de entrada
{'type': 'object', 'title': 'search_by_titleArguments', 'required': ['title'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 5}, 'title': {'type': 'string', 'title': 'Title'}, 'domain': {'type': 'string', 'title': 'Domain', 'default': 'GB'}}}
start_a2a_finder_scan
Start an A2A Finder scan: check a list of ASINs for profitable Amazon-to-Amazon flips across marketplaces (buy on one Amazon country, sell on another). Up to 100 ASINs. Optional `countries` = list of country codes to compare (e.g. ["UK","DE","FR"]); defaults to all. Uses the shared Keepa scan key (counts against the user's daily scan credits). Returns a job_id — poll get_a2a_finder_status(job_id) for results. Premium feature.
Esquema de entrada
{'type': 'object', 'title': 'start_a2a_finder_scanArguments', 'required': ['asins'], 'properties': {'asins': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Asins'}, 'countries': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Countries', 'default': None}}}
start_reverse_source_scan
Start a Reverse Source scan: for each ASIN, search Google Shopping for a cheaper source than Amazon — i.e. where to buy the product to flip it. Up to 250 ASINs. Uses the shared Keepa scan key (counts against the user's daily scan credits). Returns a job_id — poll get_reverse_source_status(job_id) for results. Premium feature.
Esquema de entrada
{'type': 'object', 'title': 'start_reverse_source_scanArguments', 'required': ['asins'], 'properties': {'asins': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Asins'}}}
start_wholesale_scan
Start a Wholesale Scanner run against a supplier price list. Each item in `products` is a dict with 'title', 'price' (cost per unit), and 'ean' (barcode — needed to match, the default scan is EAN-based). Up to 500 items. Matches each product to Amazon and returns profit/ROI. Returns a job_id — poll get_wholesale_status(job_id) for results. Premium feature.
Esquema de entrada
{'type': 'object', 'title': 'start_wholesale_scanArguments', 'required': ['products'], 'properties': {'products': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'title': 'Products'}}}
Añadido
find_products
1 de October de 2026 a las 02:52
Añadido
get_keepa_key_status
1 de October de 2026 a las 02:52
Añadido
get_repricer_settings
17 de September de 2026 a las 07:58
Añadido
get_repricer_stats
17 de September de 2026 a las 07:58
Añadido
get_repricer_log
17 de September de 2026 a las 07:58
Añadido
get_repricer_items
17 de September de 2026 a las 07:58
Añadido
get_reverse_source_jobs
17 de September de 2026 a las 07:58
Añadido
get_reverse_source_status
17 de September de 2026 a las 07:58
Añadido
start_reverse_source_scan
17 de September de 2026 a las 07:58
Añadido
get_wholesale_jobs
17 de September de 2026 a las 07:58
Añadido
get_wholesale_status
17 de September de 2026 a las 07:58
Añadido
start_wholesale_scan
17 de September de 2026 a las 07:58
Añadido
get_a2a_finder_jobs
17 de September de 2026 a las 07:58
Añadido
get_a2a_finder_status
17 de September de 2026 a las 07:58
Añadido
start_a2a_finder_scan
17 de September de 2026 a las 07:58
Añadido
check_eligibility
17 de September de 2026 a las 07:58
Añadido
get_best_sellers
17 de September de 2026 a las 07:58
Añadido
get_product_performance
17 de September de 2026 a las 07:58
Añadido
get_monthly_pnl
17 de September de 2026 a las 07:58
Añadido
get_aged_stock
17 de September de 2026 a las 07:58
Añadido
get_restock_suggestions
17 de September de 2026 a las 07:58
Añadido
get_oa_retailers
17 de September de 2026 a las 07:58
Añadido
get_analyse_history
17 de September de 2026 a las 07:58
Añadido
get_reconciliation_claims
17 de September de 2026 a las 07:58
Añadido
get_reconciliation_summary
17 de September de 2026 a las 07:58
Añadido
get_fba_reimbursements
17 de September de 2026 a las 07:58
Añadido
get_fba_refunds
17 de September de 2026 a las 07:58
Añadido
get_fba_returns
17 de September de 2026 a las 07:58
Añadido
get_fba_shipment_items
17 de September de 2026 a las 07:58
Añadido
get_fba_shipments
17 de September de 2026 a las 07:58