MCP 服务器

UniVoucher MCP Server

Enables interaction with UniVoucher's decentralized crypto gift card protocol across multiple blockchains. Supports querying documentation, retrieving real-time protocol statistics, and creating/redeeming crypto gift cards on networks like Ethereum, Polygon, BSC, and more.

README

UniVoucher MCP Server

Official Model Context Protocol (MCP) server for UniVoucher.com - the world's first decentralized crypto gift card protocol that allows users to create and redeem crypto gift cards across multiple blockchains.

What is UniVoucher?

UniVoucher is the world's first decentralized tangible crypto gift card protocol that allows users to create and redeem crypto gift cards across multiple blockchains including Ethereum, Polygon, BSC, and more.

🚀 Quick Installation

Note: No manual installation needed! Just add the configuration below to your MCP client and it will automatically download and run when needed.

MCP Configuration

Add this to your MCP configuration file (mcp.json or equivalent):

Basic Configuration (Read-only access)

{
  "mcpServers": {
    "univoucher": {
      "command": "npx",
      "args": ["-y", "univoucher-mcp@latest"],
      "env": {}
    }
  }
}

With Wallet Private Key (Full access including card creation)

{
  "mcpServers": {
    "univoucher": {
      "command": "npx",
      "args": ["-y", "univoucher-mcp@latest"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_ethereum_wallet_private_key_here"
      }
    }
  }
}

⚠️ Security Note: Never commit your wallet private key to version control. Use environment variables or secure configuration management.

📝 Note: The private key is optional. You can provide your standard Ethereum crypto wallet private key with or without the 0x prefix.

Supported MCP Clients

Cursor: Add to your Cursor MCP settings
Claude Desktop: Add to your Claude Desktop configuration
Any MCP-compatible client: Use the configuration above

Alternative Installation Methods

Global Installation

npm install -g univoucher-mcp@latest

Specific Version Installation

npm install univoucher-mcp@1.3.4

Then use univoucher-mcp directly in your MCP configuration.

Features

📚 Documentation Access

Complete UniVoucher documentation pages delivered in full
Browse and discover all available documentation
Get multiple related pages at once for comprehensive information
No more search guessing - get the exact page you need

📊 Live API Access

Query gift cards with advanced filtering
Get current fees across all supported chains
Check supported blockchain networks
Retrieve real-time protocol statistics

🛠️ Available Tools

Tool	Description
`list_doc_pages`	List all available documentation pages with descriptions
`get_doc_page`	Get complete content of a specific documentation page
`get_multiple_doc_pages`	Get complete content of multiple documentation pages at once
`query_api_cards`	Query gift cards from the protocol
`get_single_card`	Get details of a specific card
`create_gift_card`	Create a new gift card (requires private key)
`get_current_fees`	Get current protocol fees
`get_chains`	Get supported blockchain networks
`get_fee_history`	Get historical fee data

Card Creation Feature

Prerequisites

Wallet Private Key: Your standard Ethereum crypto wallet private key (with or without 0x prefix, optional)
Supported Networks: Ethereum (1), Base (8453), BNB Chain (56), Polygon (137), Arbitrum (42161), Optimism (10), Avalanche (43114)
Token Support: Any ERC-20 token or native currency

Security

Wallet private keys are only used locally and never stored
Keys are passed via environment variables for security
All transactions are signed locally and sent to UniVoucher API
Private key is optional - you can use the MCP server for read-only operations without providing a private key
Uses Direct Response Mode for immediate card details without callbacks

Supported Tokens

Native Currency: Use 0x0000000000000000000000000000000000000000 as token address
ERC-20 Tokens: Use the token's contract address
Amount Format: Use string format for large numbers (e.g., "1000000000000000000" for 1 ETH)
Bulk Creation: Create up to 100 cards in a single transaction