English Français العربية

Nexi XPay

Registre officiel E-commerce

MCP server for Nexi XPay Back Office APIs: orders, transactions, warnings.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package nexi-xpay-mcp-server
Claude Code 
claude mcp add nexi-xpay -- uvx nexi-xpay-mcp-server==1.2.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "nexi-xpay": {
            "command": "uvx",
            "args": [
                "nexi-xpay-mcp-server==1.2.1"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. nexi-xpay-mcp-server
  2. Tools
  3. Prerequisites
  4. Installation
  5. Usage in .mcp.json
  6. Environment variables
  7. Development
  8. License

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

ToolDescription
list_ordersList orders with filters (date range, channel, status, transaction code)
order_detailsFull details of a specific transaction
warningsRetrieve warnings/anomalies (default: last 7 days)
payment_methodsList 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

VariableRequiredDefaultDescription
NEXI_ALIASYes—Merchant alias (also used as API key)
NEXI_SECRET_KEYYes—Secret key for MAC calculation
NEXI_TESTNofalseSet 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

Questions fréquentes

Qu'est-ce que Nexi XPay ?

MCP server for Nexi XPay Back Office APIs: orders, transactions, warnings.

Comment installer Nexi XPay ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add nexi-xpay -- uvx nexi-xpay-mcp-server==1.2.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Nexi XPay ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Nexi XPay est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Nexi XPay ?

Il est publié par stucchi. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.