Tools Reference

All 18 Rufusly MCP tools, grouped by category. Every tool is available on every plan, including the free trial. Tools in Group 1 require an SP-API (BYOK) connection. Group 3 tools need no connection, and the ones that generate content spend credits.

---

Group 1: SP-API Live Data

Requires a BYOK SP-API connection. Set up in Settings → Connections.

get_listing_data

Returns the current Amazon listing content for an ASIN.

Returns: title, bullet_points, description, brand, category, images.

---

get_inventory_status

Returns FBA inventory levels for your catalogue.

Returns: asin, fulfillable_quantity, days_of_supply, pending_removals per ASIN.

---

get_finance_summary

Returns revenue, fees, and net proceeds for a date range.

Returns: gross_revenue, referral_fees, fba_fees, ad_spend, net_proceeds, currency.

---

get_sales_performance

Returns sales and traffic report data (async, may queue).

Returns: { status: 'complete' | 'queued', data? }. If queued, call again in 2–3 minutes with the returned report_id.

---

get_brand_analytics

Returns brand-level search funnel and repeat purchase data (async).

---

get_search_query_report

Returns search query performance per ASIN (async).

---

get_customer_voice

Returns AI-analysed review topics from Amazon's Customer Feedback API.

Returns: positive_topics, negative_topics, return_topics, each with topic name and mention count.

---

get_reimbursements

Returns FBA reimbursement report (async).

Returns: pending_total, approved_total, rejected_total, currency, items.

---

get_keyword_intelligence

Returns Brand Analytics search query performance per ASIN (async).

Returns: keywords array with query, click_share, cart_add_share, purchase_share, rank.

---

request_reviews

Sends Amazon review solicitation emails to eligible orders.

Returns: sent, failed, total. Eligible orders are those 4–30 days since purchase with no prior solicitation. Rate-limited to 1 request/second per Amazon policy.

---

Group 2: Ads API (not yet available)

Four advertising tools are designed and ready but not registered on the server, so they will not appear in your client's tool list and cannot be called:

get_campaign_performance

get_keyword_performance

get_search_term_report

get_wasted_spend

They are held back because the Amazon Advertising API application is still pending approval. Offering them as callable placeholders was worse than withholding them: an assistant would confidently call one and get nothing useful back. They will be switched on once Amazon approves the application. The advertising prompts in the Prompts Library are labelled accordingly.

---

Group 3: Content & Utilities

No Amazon connection required. Credits apply for listing and image generation tools, at the same rate as inside Rufusly.

rewrite_listing

Rewrites an Amazon listing using Rufusly's AI pipeline.

Returns: title, bullets (×5), description, backend_search_terms, item_highlights, lqs_score, compliance_flags, rufus_optimisation.

Costs 1 listing credit per call.

---

bulk_rewrite_listings

Rewrites up to 10 listings in one call.

Costs 1 listing credit per product.

---

get_lqs_score

Returns the Listing Quality Score for one or all listings.

Returns: score (0–100), breakdown by field, and improvement suggestions.

---

get_listing_history

Returns previous versions of a listing with their LQS scores.

---

generate_images

Triggers Image Studio to generate product images for an ASIN.

Returns a link to the Image Studio with the generated images. Costs 1 image credit per image type generated.

---

draft_support_case

Drafts a professional Amazon Seller Support case.

Issue types: listing_suppressed, asin_blocked, ip_complaint, inauthentic_complaint, a_to_z_claim, fba_lost_inventory, account_health, account_suspended, stranded_inventory, review_removed, pricing_error, reimbursement, other.

Returns: subject, body (ready to paste), seller_central_url, next_steps.

---

get_aplus_brief

Returns a structured brief for building Amazon A+ content in an external design tool such as Canva: title, bullets, description, brand name, and the exact module dimensions to design at.

Returns: title, bullets, description, brand, module_specs (module name, desktop and mobile dimensions, max file size), guidance. No credit cost.

---

save_image_from_url

Downloads an image from a URL (for example, an export from Canva) and saves it into your Rufusly Creative Library. Use this to bring a design made in another tool back into Rufusly.

Only https URLs are accepted, and the image must be PNG, JPEG, or WebP, up to 15MB. Limited to 30 saves per hour. No credit cost.

Returns: id, image_url.