# @ipayx/mcp-fx-audit

> **MCP server for [iPayX Protocol](https://www.ipayx.ai)** — audit FX fees, compare currency conversion margins and score cross-border payment invoices, directly inside Claude, Cursor, Cline, ChatGPT or any MCP-compatible AI client.

[![npm](https://img.shields.io/npm/v/@ipayx/mcp-fx-audit.svg)](https://www.npmjs.com/package/@ipayx/mcp-fx-audit)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## ✨ What it does

Exposes 4 tools to your AI assistant:

| Tool | Description |
| --- | --- |
| `audit_fx_fee` | Compute the hidden FX fee on a conversion vs the real mid-market rate |
| `compare_providers` | Compare live FX quotes across Wise, OFX, Airwallex, banks, etc. |
| `score_invoice` | Grade an invoice 0–100 on FX fairness with explanation |
| `get_mid_market_rate` | Return the real ECB mid-market rate for any currency pair |

## 🚀 Install

### Claude Desktop
```json
{
  "mcpServers": {
    "ipayx-fx-audit": {
      "command": "npx",
      "args": ["-y", "@ipayx/mcp-fx-audit"],
      "env": { "IPAYX_API_KEY": "optional_for_live_provider_quotes" }
    }
  }
}
```

### Cursor / Cline / Continue
Same config — drop into your MCP settings.

### Smithery
```bash
npx -y @smithery/cli install @ipayx/mcp-fx-audit --client claude
```

## 🔑 API Key

Mid-market rates work without a key (powered by ECB via exchangerate.host).
For **live provider comparisons**, get a free key at [ipayx.ai](https://www.ipayx.ai).

## 🇫🇷 Pour les utilisateurs francophones

Serveur MCP qui audite les frais de change FX cachés et compare les fournisseurs (Wise, OFX, Airwallex, banques canadiennes). Connecte-le à Claude Desktop ou Cursor en 30 secondes.

## License

MIT © 2026 [iPayX Protocol](https://www.ipayx.ai)