# payments-reliability-copilot-mcp

Payment reliability MCP server for dunning strategy, failure simulation, billing guardrails, fee leakage analysis, and incident summaries.

[![Available on MCPize](https://img.shields.io/badge/MCPize-Available-blue)](https://mcpize.com/servers/payments-reliability-copilot-mcp)

## Tools

| Tool | Description |
|------|-------------|
| `recommend_retry_strategy` | Suggests retry cadence and channels based on decline code and segment |
| `simulate_payment_failure` | Projects outcomes for retry policies on failed transactions |
| `validate_billing_guardrails` | Enforces tier limits, country policies, and risk thresholds |
| `detect_fee_leakage` | Compares actual fees against expected rates and flags leakage |
| `summarize_payment_incident` | Converts event logs into severity, probable causes, and actions |

## Quick Start

```bash
npm install
cp .env.example .env
npm run dev
```

Server runs with MCPize dev on `http://localhost:3000/mcp`.

## Configuration

| Variable | Required | Description |
|----------|----------|-------------|
| `PORT` | No | Runtime port (MCPize cloud sets this automatically) |
| `NODE_ENV` | No | `development` enables request/response dev logs |

## Development

```bash
mcpize dev               # Best local dev path
mcpize dev --playground  # Public tunnel + browser playground
npm test                 # Unit tests
npm run test:smoke       # MCP protocol smoke test
npm run build            # Compile TypeScript
```

## Deploy

```bash
mcpize login
mcpize deploy
```

## Connect via MCPize

```bash
npx -y mcpize connect @azharul.sylhet/payments-reliability-copilot-mcp --client claude
```

Or visit: https://mcpize.com/mcp/payments-reliability-copilot-mcp

## Per-client install commands

```bash
claude mcp add --transport http payments-reliability-copilot-mcp https://payments-reliability-copilot-mcp.mcpize.run/mcp
cursor mcp add payments-reliability-copilot-mcp https://payments-reliability-copilot-mcp.mcpize.run/mcp
windsurf mcp add payments-reliability-copilot-mcp https://payments-reliability-copilot-mcp.mcpize.run/mcp
cline mcp add payments-reliability-copilot-mcp https://payments-reliability-copilot-mcp.mcpize.run/mcp
```

## JSON config

```json
{
  "mcpServers": {
    "payments-reliability-copilot-mcp": {
      "url": "https://payments-reliability-copilot-mcp.mcpize.run/mcp"
    }
  }
}
```

## License

MIT