Skip to main content
Glama

Fairshop: e-commerce and retail back-office agents

English · Deutsch · Français · Español · Português (Brasil) · Italiano · 日本語 · 简体中文 · 한국어

30 small agents for online sellers and shops with a till. Each does one back-office job, on your computer, from files you already export: Shopify, WooCommerce, BigCommerce, Amazon Seller Central, eBay, Etsy, Walmart Marketplace, Stripe, PayPal, Square, ShipStation, Shippo and your 3PL's invoices. Each writes a worklist (CSV with a blank decision column, and an HTML page) and, where something needs sending, a draft that waits for one named person.

The software is free (MIT). Mythos Machines sells a fixed-price setup on your own files: see fair-agents.com.

What no agent does

No agent refunds, charges, pays, reprices, changes a listing, disables a code, files a tax return, registers with a state, sends a message or posts to a ledger. Those steps are refused, or wait for one named person's click, even in Auto mode. Every call is written to a hash-chained audit log.

Related MCP server: fairpractice-agents

Customer and staff data

Shopper names, e-mail addresses, phone numbers, street addresses and staff names are replaced by stable pseudonyms in everything the AI model sees. The files written on your disk keep the real values for the people who work the lists.

Files from other countries

Exports from systems in Germany, France, Spain, Brazil, Italy, Japan, China and Korea are read through the shared core: local column names, Windows-1252, Shift_JIS, GBK and EUC-KR text, 1.234,56 amounts and day-first or year-first dates. Report pages can be written in nine languages with --lang de|fr|es|pt|it|ja|zh|ko; tool results and CSV files stay in English.

Sales tax rates, marketplace facilitator rules and nexus thresholds are settings you confirm with your adviser. Nothing here is tax, legal or accounting advice.

The agents

Payouts, fees and marketplace money

Agent

Package

Fairshop Payouts

fairshop-payouts

Orders against payout lines by channel: never paid out, paid short, paid twice, refunds not yet deducted, fees above your rate.

Fairshop Marketplace Fees

fairshop-marketplace-fees

Every marketplace fee line against the fee schedule you confirm, and fee rates that moved month to month.

Fairshop FBA Reimbursements

fairshop-fba-reimbursements

Lost and damaged FBA units, refunds with no return and low reimbursements, each with a claim-by date.

Fairshop FBA Storage Fees

fairshop-fba-storage-fees

Storage fees against your rates, and inventory lots about to cross into the next aged-inventory bracket.

Fairshop Processor Reserves

fairshop-processor-reserves

Stripe, PayPal and Shopify reserves: releases overdue, holds above your terms, releases coming up.

Fairshop Settlement Journals

fairshop-settlement-journals

One balanced journal entry per marketplace settlement from your account map, matched to the bank deposit.

Fairshop Marketplace Claims

fairshop-marketplace-claims

A-to-z, eBay, Walmart and Etsy claims against your tracking: respond-by dates and what your records prove.

Returns, refunds and customers

Agent

Package

Fairshop Refunds Returns

fairshop-refunds-returns

Refunds whose item never came back, returns never refunded, refunds paid twice or above the price.

Fairshop Return Reasons

fairshop-return-reasons

Why things come back, by SKU, and customers who return most of what they buy (masked).

Fairshop Coupon Abuse

fairshop-coupon-abuse

Discount codes used past their limit, out of date, under the minimum, or by returning shoppers.

Fairshop Gift Cards

fairshop-gift-cards

Gift card and store credit liability by age, and cards whose balances do not add up.

Fairshop Subscriptions

fairshop-subscriptions

Failed payments not retried, retries used up, cards about to expire, and churn by cause.

Fairshop Affiliate Commissions

fairshop-affiliate-commissions

Commissions on refunded or missing orders, above your rate, paid twice, or on own-link purchases.

Sales tax

Agent

Package

Fairshop Sales Tax

fairshop-sales-tax

Tax collected on each order against the rates and rules you confirm, by state, with marketplace orders apart.

Fairshop Nexus Thresholds

fairshop-nexus-thresholds

Sales and orders by state against the thresholds you confirm, with the date each was met.

Inventory, listings and pricing

Agent

Package

Fairshop Inventory Listings

fairshop-inventory-listings

Stock by location against what each channel lists: oversell risk, missed sales and stock listed nowhere.

Fairshop Stockouts

fairshop-stockouts

Days out of stock, orders taken with nothing on hand, and SKUs to reorder before they run out.

Fairshop Product Data

fairshop-product-data

Missing GTINs, brands, weights and images, titles over your limits and GTINs with a wrong check digit.

Fairshop Duplicate Listings

fairshop-duplicate-listings

The same SKU listed twice, look-alike titles, shared GTINs and listings for SKUs you do not carry.

Fairshop MAP Pricing

fairshop-map-pricing

Advertised prices against your MAP list: your own listings first, then resellers and repeat ones.

Fairshop SKU Margins

fairshop-sku-margins

Contribution margin per SKU and channel after fees, labels and unit cost.

Fairshop Ad Spend

fairshop-ad-spend

Campaigns under your target return, spend with no sales, ads on out-of-stock SKUs, and over-attribution.

Shipping, fulfilment and purchasing

Agent

Package

Fairshop Shipping Costs

fairshop-shipping-costs

Shipping charged against labels bought: losses, free shipping under your threshold, duplicate and unrefunded labels.

Fairshop Carrier Adjustments

fairshop-carrier-adjustments

Carrier adjustments your own label data disproves, and SKUs whose packaging data keeps causing them.

Fairshop 3PL Invoices

fairshop-3pl-invoices

A 3PL invoice against your rate card and your own order, receipt and pallet counts.

Fairshop PO Receiving

fairshop-po-receiving

Purchase orders, receipts and supplier invoices matched: billed not received, billed twice, price above the PO.

Fairshop Landed Cost

fairshop-landed-cost

Freight, duty and broker costs spread over each shipment's SKUs, against the cost recorded in your store.

Fairshop Retailer Deductions

fairshop-retailer-deductions

Retailer deductions your proof of delivery or agreements disprove, with dispute dates.

Physical stores

Agent

Package

Fairshop Cash Over Short

fairshop-cash-over-short

Register drawers over or short, and deposits missing or different from the counted cash.

Fairshop Store Shrink

fairshop-store-shrink

Shrink by store and category against sales, unexplained losses and SKUs written off again and again.

Try one

npx -y fairshop-payouts demo
npx -y fairshop-payouts mcp --root /path/to/your/exports
npx -y fairshop-payouts call payouts_audit '{"orders":"orders.csv","payouts":"payouts.csv"}' --lang de

How it is checked

See REVIEW-ver1.md for every check with its numbers: tests, eval cases, hostile inputs, eight-language files, the 10,000-row speed test and the release check. All data in this repository is fictional.

Licence

MIT. Built by Mythos Machines.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers