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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Packagenexi-xpay-mcp-server
TransportSTDIO
UpdatedFeb 22, 2026
