# maib-mcp

MCP server for MAIB e-commerce payments (Moldova). Supports payments, refunds, recurring billing, one-click payments, and transaction status via OAuth 2.0.

## Tools (8)

| Tool | Description |
|---|---|
| `create_payment` | Create a new MAIB payment |
| `get_payment` | Get payment details by ID |
| `refund_payment` | Refund a payment |
| `create_recurring` | Create recurring payment |
| `get_recurring` | Get subscription details |
| `cancel_recurring` | Cancel a subscription |
| `create_one_click_payment` | One-click payment with saved card |
| `get_transaction_status` | Get detailed transaction status |

## Quick Start

```json
{
  "mcpServers": {
    "maib": {
      "command": "npx",
      "args": ["-y", "@theyahia/maib-mcp"],
      "env": {
        "MAIB_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "MAIB_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "MAIB_PROJECT_ID": "<YOUR_PROJECT_ID>"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `MAIB_CLIENT_ID` | Yes | OAuth client ID from MAIB developer portal |
| `MAIB_CLIENT_SECRET` | Yes | OAuth client secret |
| `MAIB_PROJECT_ID` | Yes | Project ID from MAIB dashboard |

## Demo Prompts

- "Create a payment for 500 MDL for an electronics order"
- "Check payment status for pay-12345"
- "Refund 200 MDL from payment pay-67890"
- "Create a one-click payment of 100 MDL using saved card biller-001"
- "Set up a recurring payment of 50 MDL"

## License

MIT