1. Conduid
  2. Commerce
  3. Nexi XPay
MCP server · Commerce

Nexi XPay

· github.com/stucchi/nexi-xpay-mcp-server

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

Unclaimed commerce
InstallView source
37Low

Scored 6 months ago · breakdown

About Nexi XPay

Nexi XPay is an MCP server in the Commerce category: mCP server for Nexi XPay Back Office APIs: orders, transactions, warnings.

Install

uvx
uvx nexi-xpay-mcp-server
pip
pip install nexi-xpay-mcp-server

This 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

Powered by Claude · Grounded in docs

I know everything about Nexi XPay. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

nexi-xpay-mcp-server

MCP PyPI

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.

Questions

About Nexi XPay

How do I install Nexi XPay?

Run uvx nexi-xpay-mcp-server, then add the server to your MCP client's configuration.

Is Nexi XPay safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Nexi XPay still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.