Back to Browse

Nexi Xpay MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (10/10 approved).

12 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-stucchi-nexi-xpay": {
      "args": [
        "nexi-xpay-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

nexi-xpay-mcp-server

MCP PyPI License: MIT

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_ALIASYesMerchant alias (also used as API key)
NEXI_SECRET_KEYYesSecret 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

Reviews

No reviews yet

Be the first to review this server!