Summary
Connects Claude to Nexi XPay's Back Office APIs so you can query payment data without leaving your chat. You get four tools: list orders with filters for date ranges and transaction status, pull full transaction details, check warnings and anomalies from the last week, and see which payment methods are active on your merchant account. Needs your Nexi merchant alias and secret key as environment variables. Supports multiple merchant configurations if you're managing several accounts, and includes a test mode flag for sandbox environments. Built for merchants who want conversational access to their Italian payment processing data.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Packagenexi-xpay-mcp-server
TransportSTDIO
UpdatedFeb 22, 2026
