{
  "markdown": "# nexi-xpay-mcp-server\n\n[![MCP](https://badge.mcpx.dev/default)](https://modelcontextprotocol.io)\n[![PyPI](https://img.shields.io/pypi/v/nexi-xpay-mcp-server)](https://pypi.org/project/nexi-xpay-mcp-server/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP server for the **Nexi XPay Back Office APIs**. Enables AI assistants (Claude, Cursor, etc.) to query orders, transaction details, warnings/anomalies, and payment methods from your Nexi XPay merchant account.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_orders` | List orders with filters (date range, channel, status, transaction code) |\n| `order_details` | Full details of a specific transaction |\n| `warnings` | Retrieve warnings/anomalies (default: last 7 days) |\n| `payment_methods` | List active payment methods for the merchant |\n\n## Prerequisites\n\n- Python >= 3.10\n- A Nexi XPay merchant account with Back Office API access\n- API credentials: **Alias**, **API Key** and **Secret Key** (from Nexi Back Office)\n\n## Installation\n\n```bash\nuvx nexi-xpay-mcp-server\n```\n\n## Usage in .mcp.json\n\nAdd to your MCP configuration file (`.mcp.json` for Claude Code, `claude_desktop_config.json` for Claude Desktop):\n\n```json\n{\n  \"mcpServers\": {\n    \"nexi\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nexi-xpay-mcp-server\"],\n      \"env\": {\n        \"NEXI_ALIAS\": \"your_alias\",\n        \"NEXI_SECRET_KEY\": \"your_secret_key\"\n      }\n    }\n  }\n}\n```\n\n### Multiple merchants\n\nUse different keys to run one instance per merchant:\n\n```json\n{\n  \"mcpServers\": {\n    \"nexi-acme\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nexi-xpay-mcp-server\"],\n      \"env\": {\n        \"NEXI_ALIAS\": \"acme_merchant\",\n        \"NEXI_SECRET_KEY\": \"acme_secret_key\"\n      }\n    },\n    \"nexi-globex\": {\n      \"command\": \"uvx\",\n      \"args\": [\"nexi-xpay-mcp-server\"],\n      \"env\": {\n        \"NEXI_ALIAS\": \"globex_merchant\",\n        \"NEXI_SECRET_KEY\": \"globex_secret_key\"\n      }\n    }\n  }\n}\n```\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n|----------|:--------:|---------|-------------|\n| `NEXI_ALIAS` | Yes | — | Merchant alias (also used as API key) |\n| `NEXI_SECRET_KEY` | Yes | — | Secret key for MAC calculation |\n| `NEXI_TEST` | No | `false` | Set to `true` to use the test environment |\n\n## Development\n\n```bash\ngit clone https://github.com/stucchi/nexi-xpay-mcp-server.git\ncd nexi-xpay-mcp-server\nuv sync\n```\n\nLocal run:\n\n```bash\nNEXI_ALIAS=your_alias NEXI_SECRET_KEY=your_secret uv run nexi-xpay-mcp-server\n```\n\n## License\n\nMIT\n\n<!-- mcp-name: io.github.stucchi/nexi-xpay -->\n",
  "bytes": 2615,
  "sha": "e02a83468cf404434560493fc5a22204b5b953b23ca6a2688d1613bf89ee491e",
  "repo_slug": "stucchi/nexi-xpay-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_stucchi_nexi_xpay_249e5cfd/readme"
}