Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: moves money, runs code or commands, deletes data, or sends messages for you.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
uvx nexi-xpay-mcp-server
MCP client config
{
"mcpServers": {
"nexi-xpay": {
"command": "uvx",
"args": [
"nexi-xpay-mcp-server"
]
}
}
}nexi-xpay-mcp-server
MCP 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.
Tools
| Tool | Description |
|---|---|
list_orders | List orders with filters (date range, channel, status, transaction code) |
order_details | Full details of a specific transaction |
warnings | Retrieve warnings/anomalies (default: last 7 days) |
payment_methods | List active payment methods for the merchant |
Prerequisites
- Python >= 3.10
- A Nexi XPay merchant account with Back Office API access
- API credentials: Alias, API Key and Secret Key (from Nexi Back Office)
Installation
uvx nexi-xpay-mcp-server
Usage in .mcp.json
Add to your MCP configuration file (.mcp.json for Claude Code, claude_desktop_config.json for Claude Desktop):
{
"mcpServers": {
"nexi": {
"command": "uvx",
"args": ["nexi-xpay-mcp-server"],
"env": {
"NEXI_ALIAS": "your_alias",
"NEXI_SECRET_KEY": "your_secret_key"
}
}
}
}
Multiple merchants
Use different keys to run one instance per merchant:
{
"mcpServers": {
"nexi-acme": {
"command": "uvx",
"args": ["nexi-xpay-mcp-server"],
"env": {
"NEXI_ALIAS": "acme_merchant",
"NEXI_SECRET_KEY": "acme_secret_key"
}
},
"nexi-globex": {
"command": "uvx",
"args": ["nexi-xpay-mcp-server"],
"env": {
"NEXI_ALIAS": "globex_merchant",
"NEXI_SECRET_KEY": "globex_secret_key"
}
}
}
}
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
NEXI_ALIAS | Yes | — | Merchant alias (also used as API key) |
NEXI_SECRET_KEY | Yes | — | Secret key for MAC calculation |
NEXI_TEST | No | false | Set to true to use the test environment |
Development
git clone https://github.com/stucchi/nexi-xpay-mcp-server.git
cd nexi-xpay-mcp-server
uv sync
Local run:
NEXI_ALIAS=your_alias NEXI_SECRET_KEY=your_secret uv run nexi-xpay-mcp-server
License
MIT
