About Nexi Xpay MCP Server
Nexi Xpay MCP Server is an MCP server published by stucchi in the Developer Tools category: server MCP per le API Back Office di Nexi XPay. Permette agli assistenti AI (Claude, Cursor, ecc.) di consultare ordini, dettagli transazioni, warning e metodi di pagamento del tuo account merchant Nexi XPay. Supporta più merchant tramite istanze separate.
Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/stucchi/nexi-xpay-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
list_ordersList orders with filters (date range, channel, status, transaction code)
Parameters not published.
order_detailsFull details of a specific transaction
Parameters not published.
payment_methodsList active payment methods for the merchant
Parameters not published.
warningsRetrieve warnings/anomalies (default: last 7 days)
Parameters not published.
Ask AI
Ask AI about Nexi Xpay MCP Server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
3 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.