Tazapay MCP Server

The Tazapay MCP Server is a Model Context Protocol (MCP) server designed to bridge LLM-based tools with Tazapay's Payments API. It supports structured tool invocation for seamless payment automation and foreign exchange capabilities.

Features

• Payment Link Generation via Tazapay API
• Real-Time FX Rate Conversion
• Account Balance Retrieval
• Complete Payin/Payout Management
• Beneficiary Management
• Customer Management
• Checkout Session Management
• Modular Tool Architecture
• Fully Compatible with Anthropic Claude, GitHub Copilot, Cursor IDE
• Supports both Standard I/O and Streamable HTTP modes

Tech Stack

| Component | Technology | |-----------|------------| | Language | Go | | Framework | Anthropic MCP Plugin (mark3labs/mcp-go) | | Containerization | Docker |

Quick Start - Remote Server (Recommended)

The easiest way to use Tazapay MCP Server is via our hosted remote server.

Remote Server URL: https://mcp.tazapay.com/stream

Claude Desktop Configuration (Remote)

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "Tazapay-Remote-Server": {
      "type": "streamable-http",
      "url": "https://mcp.tazapay.com/stream",
      "headers": {
        "Authorization": "Basic <base64_encoded_api_key:api_secret>"
      }
    }
  }
}

Note: Replace <base64_encoded_api_key:api_secret> with your Base64-encoded TAZAPAY_API_KEY:TAZAPAY_API_SECRET string.

VS Code / GitHub Copilot Configuration (Remote)

Add to your settings.json:

{
  "mcp": {
    "servers": {
      "Tazapay-Remote-Server": {
        "type": "streamable-http",
        "url": "https://mcp.tazapay.com/stream",
        "headers": {
          "Authorization": "Basic <base64_encoded_api_key:api_secret>"
        }
      }
    }
  }
}

Cursor IDE Configuration (Remote)

Go to Settings > MCP > Add New Global MCP Server and use:

{
  "Tazapay-Remote-Server": {
    "type": "streamable-http",
    "url": "https://mcp.tazapay.com/stream",
    "headers": {
      "Authorization": "Basic <base64_encoded_api_key:api_secret>"
    }
  }
}

Docker Setup

Pull and Run with Docker

# Pull the Docker image
docker pull tazapay/tazapay-mcp-server:latest

# Run in Standard I/O mode (for Claude Desktop)
docker run --rm -i \
  -e TAZAPAY_API_KEY=your_api_key \
  -e TAZAPAY_API_SECRET=your_api_secret \
  tazapay/tazapay-mcp-server:latest

# Run in Streamable HTTP mode
docker run --rm -p 8081:8081 \
  -e TAZAPAY_API_KEY=your_api_key \
  -e TAZAPAY_API_SECRET=your_api_secret \
  -e SERVER_TYPE=streamablehttp \
  tazapay/tazapay-mcp-server:latest

Claude Desktop Configuration (Docker)

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "Tazapay-Docker-Server": {
      "command": "docker",
      "description": "MCP server to integrate Tazapay API's and payments solutions.",
      "args": [
        "run", "--rm", "-i",
        "-e", "TAZAPAY_API_KEY",
        "-e", "TAZAPAY_API_SECRET",
        "tazapay/tazapay-mcp-server:latest"
      ],
      "env": {
        "TAZAPAY_API_KEY": "your_tazapay_api_key",
        "TAZAPAY_API_SECRET": "your_tazapay_api_secret"
      }
    }
  }
}

Local Development Setup

Prerequisites

• Go 1.24+
• An IDE or tool that supports MCP (e.g., Claude Desktop, GitHub Copilot, Cursor IDE)

Step 1: Create Configuration File

Add a .tazapay-mcp-server.yaml config file in your home directory:

TAZAPAY_API_KEY: "your_key"
TAZAPAY_API_SECRET: "your_secret"

Verify the configuration file exists:

[ -f "$HOME/.tazapay-mcp-server.yaml" ] && echo "Config file found." || echo "Config file missing at $HOME/.tazapay-mcp-server.yaml"

Step 2: Clone and Build

git clone https://github.com/tazapay/tazapay-mcp-server.git
cd tazapay-mcp-server
go build -o tazapay-mcp-server ./cmd/server

Step 3: Configure Claude Desktop (Lo

... View full README on GitHub