Developer Documentation

ZPAY MCP Server

Connect AI models like Claude directly to the Stellar network. Build autonomous agents capable of sending, requesting, and escrowing funds.

How it Works

The Model Context Protocol (MCP) bridges the gap between conversational AI (like Claude Desktop) and your ZPAY account. When you type Pay 50 XLM to div@Zp, Claude uses the ZPAY MCP server to dynamically execute a Soroban smart contract transaction on your behalf.

Installation

To install the MCP server into Claude Desktop, you need to add the ZPAY executable to your Claude configuration file.

claude_desktop_config.json

{
  "mcpServers": {
    "zpay": {
      "command": "npx",
      "args": ["-y", "@zpay/mcp-server"],
      "env": {
        "ZPAY_API_KEY": "zp_live_your_api_key_here"
      }
    }
  }
}

Exposed Tools

ƒ send_p2p_payment

Executes a direct payment to another ZPAY user.

Params: recipient_id (string), amount (number), currency (string)

ƒ create_escrow_contract

Locks funds in a Soroban smart contract linked to a milestone.

Params: freelancer_id (string), amount (number), terms (string)

ƒ get_zpay_balance

Fetches current balances in XLM and fiat equivalents.

Params: none

Security & Signatures

User-Approved Execution

The AI does not have raw access to your Stellar secret keys. When Claude attempts to execute a payment, the MCP server will create a pending transaction and return an approval link to the chat. You must explicitly click the link and sign the transaction via your web dashboard to authorize the movement of funds.

GetStarted.

Fast, secure, and borderless payments powered by ZPAY on Stellar.

Request Access Explore Features

ZPAY

The agentic payment router built on Stellar. Instant, borderless, and programmable by AI.