{"uid":"cap_Z7RHcRFzZnyeX88VZz-lE","slug":"invoice-duplicate-overpayment-recovery-analyzer-55c1dfac","name":"Invoice Duplicate & Overpayment Recovery Analyzer","description":"Customer-input analysis tools with per-call x402 v2 USDC payments on Base. Discovery and examples are free.","url":"https://mcp-factory.bowling-anthony.workers.dev/invoice-duplicate-recovery/analyze","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"ok":true,"counts":{"issues":0,"credits":1,"invoices":1,"payments":2,"credit_requests":1,"duplicate_imports":0},"invoices":[{"issues":[],"summary":{"net":"180.00","gross":"200.00","credited":"20.00","expected":"100.00","overpaid":"80.00","net_minor":"18000","gross_minor":"20000","outstanding":"0.00","credited_minor":"2000","expected_minor":"10000","overpaid_minor":"8000","outstanding_minor":"0"},"currency":"USD","vendor_id":"V1","credit_ids":["C1"],"invoice_id":"INV-100","payment_ids":["P1","P2"],"minor_unit_digits":2,"excluded_payment_ids":[]}],"disclaimer":"Computed evidence bundle for requesting vendor credit review. Not a legal or financial determination of refund entitlement, and no request or financial action is sent or taken automatically.","orphan_credits":[],"credit_requests":[{"amount":"80.00","reason":"net_payments_exceed_supplied_invoice_total","currency":"USD","evidence":{"credits":[{"amount":"20.00","credit_id":"C1","payment_id":"P2"}],"invoice":{"amount":"100.00","currency":"USD","vendor_id":"V1","invoice_id":"INV-100"},"payments":[{"amount":"100.00","currency":"USD","payment_id":"P1"},{"amount":"100.00","currency":"USD","payment_id":"P2"}]},"vendor_id":"V1","credit_ids":["C1"],"invoice_id":"INV-100","payment_ids":["P1","P2"],"amount_minor":"8000"}],"orphan_payments":[],"duplicate_imports":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_StCe71uMAoun_wedDmYzv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes invoices, payments, and credits to detect overpayments, duplicate imports, and generate credit recovery request evidence bundles","exampleAgentPrompt":"I think we overpaid vendor V1 on invoice INV-100 — we have two payments of $100 each plus a $20 credit applied. Can you run the invoice duplicate recovery analysis and tell me if we're owed a refund and how much?","exampleUseCases":[{"title":"Vendor overpayment credit request","prompt":"We paid invoice INV-205 from vendor ACME twice — $500 each time — and also have a $50 credit on file. Run an overpayment analysis and generate the evidence bundle I need to request a credit back from them."},{"title":"Duplicate import detection before close","prompt":"Before we close the books this month, can you analyze these invoice and payment records for vendor GLOBEX to check if any payments were imported more than once and flag anything that looks like a duplicate?"},{"title":"Reconcile outstanding balances for audit","prompt":"I need to reconcile all payments and credits against invoice INV-880 for vendor BETA-CORP and get a breakdown of gross, net, credited, and outstanding amounts so I can respond to an audit query."}],"resultDescription":"Returns a JSON object with per-invoice summaries including gross, net, credited, expected, overpaid, and outstanding amounts in both decimal and minor units; a list of credit requests with reason codes and full evidence bundles (linked payment IDs, credit IDs, invoice details); lists of orphan payments, orphan credits, and duplicate imports; and a disclaimer clarifying this is a computed evidence bundle, not a legal or financial determination.","failureModes":["Mismatched currency codes across payments and invoices may cause computation errors","Missing or malformed invoice/payment IDs result in orphan records rather than matched analysis","Incorrect minor unit digit specification leads to wrong amount calculations","Payments referencing non-existent invoices returned as orphan_payments with no credit request generated","Invalid or missing vendor_id may result in empty or unlinked result sets"],"whenToPreferThis":"Use this endpoint when you need to programmatically detect overpayments, duplicate payments, or misapplied credits across vendor invoices and need a structured evidence bundle suitable for initiating a credit recovery request. It is specifically suited to accounts-payable reconciliation workflows where multiple payments and credits may apply to a single invoice. Prefer this over manual spreadsheet reconciliation or generic accounting APIs when you need auditability and a machine-readable evidence bundle with per-invoice breakdowns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T21:09:17.423Z","isFirstParty":false}