Adaptis MCP Server

A local Model Context Protocol (MCP) server for the Adaptis (MEG) payment gateway. It lets AI agents (Claude Desktop, Claude Code, Cursor, and any other MCP client) help you integrate with and operate against the Adaptis APIs using your own merchant credentials.

The server runs locally on your machine (stdio transport). Your Merchant Key never leaves your computer except inside signed requests sent directly to the Adaptis gateway — exactly like your own backend integration would.

Features

Gateway actions (call the Adaptis APIs directly):

Integration helpers (no network — generate signed artifacts):

Reference lookups (offline):

Related MCP server: btcpay-mcp

Prerequisites

• Node.js 18+

• Adaptis Merchant Code and Merchant Key (contact Adaptis support for sandbox credentials)

Installation

git clone https://github.com/fredericktvf/adaptis-mcp-server.git
cd adaptis-mcp-server
npm install
npm run build

Configuration

Claude Desktop / Claude Code

Add to claude_desktop_config.json (Settings → Developer → Edit Config), or .mcp.json for Claude Code:

{
  "mcpServers": {
    "adaptis": {
      "command": "node",
      "args": ["/path/to/adaptis-mcp-server/dist/index.js"],
      "env": {
        "ADAPTIS_MERCHANT_CODE": "MMXXXXXX",
        "ADAPTIS_MERCHANT_KEY": "<<YOUR_MERCHANT_KEY>>",
        "ADAPTIS_ENVIRONMENT": "sandbox",
        "ADAPTIS_ENABLE_REFUNDS": "false",
        "ADAPTIS_TOOLS": "all"
      }
    }
  }
}

Cursor

Settings → Tools & MCP → Add MCP Server, using the same JSON block.

Example production config (least privilege)

"env": {
  "ADAPTIS_MERCHANT_CODE": "MMXXXXXX",
  "ADAPTIS_MERCHANT_KEY": "<<LIVE_KEY>>",
  "ADAPTIS_ENVIRONMENT": "production",
  "ADAPTIS_TOOLS": "adaptis_requery_transaction,adaptis_check_gateway_health,adaptis_lookup_status_codes,adaptis_lookup_error_codes"
}

Usage examples

Ask your AI client things like:

• "Create a MYR 150 payment link for invoice INV-2044, expiring end of this month, and email it to the customer."

• "Requery transaction ADP20260712093000 for 1.00 — did it go through?"

• "Why am I getting error 100004 on my requery call? Here's my base string..."

• "Generate the hosted checkout form for a RM 25 test payment."

• "Which payment methods are down right now?"

• "Verify this backend callback: TransId TR2529..., RefNo ..., Amount 1.00, Status 1, Signature ..."

Security notes

• Sandbox by default. Production must be enabled explicitly.

• Refunds are opt-in. adaptis_refund_transaction moves money and only exists when ADAPTIS_ENABLE_REFUNDS=true. Your AI client will additionally ask for confirmation (the tool is marked destructive).

• Tool whitelisting. Use ADAPTIS_TOOLS to expose only what you need, following least privilege.

• Merchant key masking. Debug outputs (raw signature base strings) mask your merchant key.

• Card data. Merchant Hosted and card-based Server Initiate flows carry PANs. Use sandbox test cards for integration; real card handling requires PCI DSS compliance.

• Callbacks. Always verify callback signatures (adaptis_verify_callback_signature), reply RECEIVEOK, and requery to independently confirm before fulfilling orders.

Signature formulas (reference)

Amounts are stripped of dots/commas before signing (1.00 → 100).

Development

npm run dev      # run from source with tsx
npm run build    # compile to dist/
npx @modelcontextprotocol/inspector node dist/index.js   # interactive testing

Support

Refer to the Adaptis Developer Portal (/developer/simulator/meg/) for the interactive API console, test data, and the full API reference.