MCP Server

Call chargeback tools that return outcomes from any MCP client. Requests authenticate by secret key.

Connecting

Setting	Value
Transport	`http` (streamable)
Host	`https://mcp.findustryai.com/`
Authentication Header	`Authorization: sk_findustryai_kkkkkkkkkkkk_nnnnn`

Tools

Tool	Category	Description
`chargeback_accept`	Write	Accept liability for chargeback requiring action
`chargeback_due`	Read	Chargebacks requiring action, soonest due first
`chargeback_get`	Read	Full detail and activity history for one chargeback
`chargeback_list`	Read	Chargebacks for one merchant, with status and due date
`chargeback_recommend`	Read	Recommendation to respond or accept, with rationale
`chargeback_respond`	Write	Approve and submit response for chargeback requiring action
`chargeback_status`	Read	Submission status for one chargeback
`evidence_attach`	Write	Attach evidence document to chargeback
`evidence_check`	Read	Evidence gaps against reason code defense requirements
`evidence_requirements`	Read	Defense requirements and time limit for card network reason code
`letter_generate`	Write	Draft response letter with rule citations
`merchant_list`	Admin	Every merchant a system-level key reaches, with each ID and external merchant ID that `merchantId` accepts
`metrics_query`	Analysis	Win rate, repeat-payer, prior-transaction, Compelling Evidence 3.0, and amount statistics across reachable merchants
`portfolio_summary`	Analysis	Metrics rolled up across reachable merchants

Write tools require an idempotencyKey.

Calling a Tool

POST /
Authorization: sk_findustryai_kkkkkkkkkkkk_nnnnn
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chargeback_list",
    "arguments": {
      "merchantId": "565500000928297"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ \"data\": [ { \"id\": \"...\", \"status\": \"action_required\", \"dueDate\": \"...\" } ] }"
      }
    ]
  }
}

Merchant Scope

merchantId scopes a request to one merchant. A request needs it only when the secret key reaches several merchants and nothing else in the request names the merchant.

merchant_list, metrics_query, and portfolio_summary do not take merchantId.

Errors

Status	Cause
`400 Bad Request`	Missing `merchantId` on a key that reaches several merchants
`401 Unauthorized`	Invalid secret key
`403 Forbidden`	Organization does not have the MCP Server enabled, contact support@findustryai.com
`404 Not Found`	Chargeback or merchant not found
`405 Method Not Allowed`	Method other than `POST`