This server reads Amazon settlement reports from your local disk and gives you cent-exact profit, loss and net-payout breakdowns per report and per SKU.
Profit and loss for one report (read_settlement_report): sales, refunds, promotions, referral and FBA fees, storage, subscription, reimbursements, and the net — plus units, orders, average price, FBA fee per unit and referral rate.
Profit after product cost: pass a landed unit cost (cogs_per_unit) and it returns profit after cost of goods.
Date filtering: narrow any report to a start/end range by posted date (the day Amazon moved the money).
Net per SKU (settlement_profit_by_sku): units, orders, sales, fees by bucket, net and net per unit per SKU; optionally isolate one SKU or show the underlying lines. Lines with no SKU (storage, subscription, most reimbursements) stay in their own group so nothing is silently spread across products.
Find your reports (list_settlement_reports): scans a folder such as Downloads and lists settlement id, period, deposit date, currency and deposit total, newest first, skipping non-settlement files.
Optional live data (agentxray_live_setup): with an AgentXray token you can add hosted tools for orders, ads and search terms, stock and inbound shipments, account health and returns; without a token the server makes no network requests and everything stays local and offline.
Trust cues: amounts are integer cents, lines reconcile to the report header's deposit (and it flags when they don't), and answers carry a basis and gaps note on what a settlement report can't show.
Reads Amazon settlement reports from local disk and computes exact-to-the-cent profit-and-loss breakdowns (sales, refunds, promotions, referral/FBA fees, storage, subscription, reimbursements, net, and profit per SKU), with optional date filtering and unit-cost input. Also lists settlement reports in a folder. With an optional AgentXray token, adds live Amazon Seller Central data such as orders, Sponsored Products ads and search terms, stock and inbound shipments, account health, and returns.
A local MCP server that reads your Amazon settlement reports and tells your AI assistant what Amazon actually paid you: sales, refunds, promotions, referral and FBA fees, storage, subscription, reimbursements, the net, and profit per SKU — exact to the cent, computed on your computer.
Runs locally, works offline. The report is read from your disk and never uploaded. No account, no API keys, no Seller Central login.
Money is integer cents. No floating-point drift; the lines reconcile to the deposit in the report header, and the server tells you when they don't.
Same parser as AgentXray's settlement reader, checked to the cent against reference results for point and comma decimals, refunds, promotions and messy transaction types (test/fixtures/settlement).
Works with Claude Desktop, Claude Code, Cursor, VS Code, and any MCP client that runs local (stdio) servers.
Tool | What it does |
| Profit and loss for one report: every bucket with its Amazon line types, net, units, orders, average price, FBA fee per unit, referral rate. Give a unit cost ( |
| The same report grouped by SKU: units, orders, sales, fees, net and net per unit. Lines without a SKU (storage, subscription, most reimbursements) stay in their own group, so the SKUs plus that group equal the net exactly. |
| Finds the settlement reports in a folder (e.g. Downloads) with settlement id, period, deposit date and total, newest first. |
Every answer carries a basis (where the numbers came from) and gaps (what a settlement report cannot show — e.g. ads billed to a card, costs outside Amazon).
Related MCP server: Amazon Seller MCP Server - DataDoe
Requires Node.js 20+.
{
"mcpServers": {
"agentxray": {
"command": "npx",
"args": ["-y", "github:agentxray-ops/amazon-seller-mcp"]
}
}
}Claude Code: claude mcp add agentxray -- npx -y github:agentxray-ops/amazon-seller-mcp
Docker: docker build -t agentxray-mcp . then mount the folder with your reports: docker run -i --rm -v ~/Downloads:/reports:ro agentxray-mcp and ask about files under /reports.
From source: git clone, npm install (builds), node dist/index.js.
Seller Central → Payments → Reports Repository → report type Transaction / Settlement → download the flat file (.txt) for a settlement period. Then ask, for example:
"Read ~/Downloads/12345678901.txt — what did Amazon actually pay me, and where did the money go?"
"My landed cost is 7.40 per unit. What was my profit in that settlement?"
"Which SKU lost money in that period? Show me the lines for SKU-123."
"List the settlement reports in my Downloads folder."
Settlement reports arrive every two weeks. If you also want live numbers — orders, Sponsored Products ads and search terms, stock and inbound shipments, account health, returns — this server can add the tools of the hosted AgentXray service. That part needs an AgentXray account and is off unless you set a token:
"env": { "AGENTXRAY_TOKEN": "axr_..." }Create the token in AgentXray → Settings → AI Assistant. Those calls go to https://agentxray.ai/api/mcp; the settlement tools stay local either way. Clients that speak remote MCP can also connect to that endpoint directly (OAuth): setup pages for Claude, ChatGPT, Claude Code and Grok are at https://agentxray.ai/connect. To try the live tools without an account, the public read-only demo token on that page reads a synthetic store.
Without a token, the server makes no network requests.
npm install # installs and builds
npm test # parser parity + MCP server tests
AGENTXRAY_TEST_TOKEN=axr_... npm test # also checks the optional live toolsMIT. Built by AgentXray (Avanta Global EOOD, Sofia, Bulgaria) — info@avantaglobalgroup.com · Security · Privacy
Amazon and Seller Central are trademarks of Amazon.com, Inc. or its affiliates. This project is independent and not affiliated with or endorsed by Amazon. Claude is a trademark of Anthropic; ChatGPT is a trademark of OpenAI.
Explains how to add live Amazon data (orders, ads, stock, account health) to this server by connecting an AgentXray account. Listed only while no AGENTXRAY_TOKEN is set; the settlement tools do not need it.
Inputs: no named parameters.
Lists the Amazon settlement reports in a folder on this computer (for example your Downloads folder), with settlement id, period, deposit date, currency and deposit total for each, newest period first. Files that are not settlement reports are skipped.
Inputs: directory (required).
Reads an Amazon settlement report (the tab-separated flat file from Seller Central → Payments → Reports Repository) from this computer and returns what Amazon actually settled: sales, refunds, promotions, referral and FBA fees, storage, subscription, reimbursements and the net, plus units, orders, average price, FBA fee per unit and referral rate. With a unit cost it also returns profit after product cost. Amounts are exact to the cent. The file never leaves this machine.
Inputs: path (required), end, start, cogs_per_unit.
Groups the lines of an Amazon settlement report by SKU and returns, for each SKU, units, orders, sales, fees by bucket, net and net per unit. Lines Amazon booked without a SKU (storage, subscription, most reimbursements) are kept as their own unattributed group instead of being spread across products, so the SKU nets plus that group equal the report's net exactly. Set include_lines to see the individual lines behind one SKU.
Inputs: path (required), end, sku, start, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 4 tools
Each tool has a clearly distinct purpose: listing local settlement files, reading one report's totals, grouping one report by SKU, and explaining live-data onboarding. The two report-reading tools are differentiated by whole-report summary versus per-SKU breakdown.
All names use snake_case, but the conventions are mixed: list_settlement_reports and read_settlement_report use verb_noun, while settlement_profit_by_sku and agentxray_live_setup are noun-phrase style. Still readable, but not a predictable pattern across the set.
Four tools are well-scoped for a settlement-report-focused server: one listing tool, two analysis tools, and one conditional onboarding helper. The count is small but each tool has a clear role.
The core settlement workflow is covered: discover local files, read totals, and break down profit by SKU. Minor gaps exist around multi-report comparison or date filtering, and the live-data option is only described rather than implemented as query tools.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Connects Amazon Seller Central and Amazon Advertising to any MCP client. Settlement-accurate P&L - every fee, refund and reimbursement as Amazon posted it - plus contribution margin and breakeven per product, per marketplace, per day. Full Sponsored Products, Brands and Display management: search terms, placements, keyword and competitor research, dayparting, automation rules. 110 tools: 78 read-only (P&L, PPC at every grain, SQP/Brand Analytics, inventory, forecasting), 28 staged writes (every change is a proposal you review and confirm before it reaches Amazon - there is no autonomous-write mode), and 4 confirmation & support tools. 4 additional AI Workforce tools appear once a client is connected.
Read-only Amazon profit, fee, ACoS, and geo-holdout MCP tools for Claude, ChatGPT, and agents.
