UniVoucher MCP Server
Supports creating and querying crypto gift cards on BNB Chain (BSC), with access to protocol fees and card management functionality.
Enables querying and creating crypto gift cards on Ethereum and other EVM-compatible blockchains, including checking protocol fees, retrieving card details, and managing decentralized gift card transactions.
Hosts the MCP server repository for bug reporting and feature requests.
Distributes the univoucher-mcp package for installation and deployment.
Enables gift card creation and management on Optimism network with support for protocol fee queries and card operations.
Allows creation and querying of crypto gift cards on Polygon network, with support for native currency and ERC-20 tokens.
Provides community support channel for UniVoucher users.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@UniVoucher MCP Server what are the current fees on Ethereum?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: evmcp
🚀 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@latestSpecific Version Installation
npm install univoucher-mcp@1.3.4Then 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 all available documentation pages with descriptions |
| Get complete content of a specific documentation page |
| Get complete content of multiple documentation pages at once |
| Query gift cards from the protocol |
| Get details of a specific card |
| Create a new gift card (requires private key) |
| Get current protocol fees |
| Get supported blockchain networks |
| 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
0x0000000000000000000000000000000000000000as token addressERC-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
Example Usage
Once configured, you can ask your AI assistant:
"Show me the complete UniVoucher integration guide for developers"
"Get me the full documentation on creating gift cards"
"What are the current fees on Ethereum?"
"List all available UniVoucher documentation pages"
"Show me the technical documentation on how UniVoucher works"
"Get the API reference and security documentation"
"How many cards are in the UniVoucher protocol?"
"Create a new gift card on Ethereum with 0.1 ETH"
"Create a gift card on Polygon with 100 USDC"
"Create 5 gift cards on Base with 50 USDC each"
Links
Official Website: univoucher.com
Documentation: docs.univoucher.com
API: api.univoucher.com
GitHub: UniVoucher MCP Repository
NPM Package: univoucher-mcp
Support
GitHub Issues: Report bugs or request features
Telegram: UniVoucher Community
Email: support@univoucher.com
License
Business Source License 1.1 - see LICENSE file for details
This project will transition to MIT License on 2035-05-04
Built with ❤️ for the UniVoucher ecosystem | Visit UniVoucher.com
Available Tools
9 toolscreate_gift_cardB
Create a new UniVoucher gift card using your standard Ethereum crypto wallet private key. The private key is optional and can be set via WALLET_PRIVATE_KEY environment variable (with or without 0x prefix). Uses Direct Response Mode for immediate card details.
Inputs: chainId (required), tokenAddress (required), tokenAmount (required), message, +2 more.
get_chainsC
Get information about supported chains
Inputs: chain.
get_current_feesC
Get current fee percentages for chains
Inputs: chainId.
get_doc_pageB
Get the complete content of a specific UniVoucher documentation page. Much more effective than searching - returns the entire page content.
Inputs: page (required).
get_fee_historyC
Get fee update history for a specific chain
Inputs: chainId (required).
get_multiple_doc_pagesB
Get the complete content of multiple UniVoucher documentation pages at once. Useful when you need comprehensive information across multiple related topics.
Inputs: pages (required).
get_single_cardA
Get details of a single card by ID (integer) or slot ID (string). Provide either id OR slotId, not both.
Inputs: id, slotId.
list_doc_pagesC
List all available UniVoucher documentation pages with their descriptions to help find the right content
Inputs: category.
query_api_cardsC
Query UniVoucher cards with various filters
Inputs: page, limit, status, chain, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools have distinct purposes, such as create_gift_card for creation, get_single_card for retrieval, and query_api_cards for filtering. However, get_doc_page and get_multiple_doc_pages overlap slightly in functionality, as both retrieve documentation content, which could cause minor confusion in selection.
All tool names follow a consistent verb_noun pattern using snake_case, such as create_gift_card, get_chains, and list_doc_pages. This uniformity makes the tool set predictable and easy to understand for an agent.
With 9 tools, the count is well-scoped for a UniVoucher server covering gift card operations, chain information, fees, and documentation. Each tool appears to serve a specific function without redundancy, fitting within the typical 3-15 range for a focused domain.
The tool surface covers key areas like gift card creation, retrieval, and querying, as well as chain and fee information, but lacks update or delete operations for gift cards, which are common in CRUD workflows. This gap could lead to agent failures when full lifecycle management is needed.
Related MCP Connectors
Verified EVM, Aptos and finance tools for AI agents; gas for 14 chains. Pay per call (x402).
Doc search, intent & cross-chain swaps, limit orders, portfolio, spot prices, gas & all APIs.
Swap, bridge and get gas on 6 EVM chains. Each plan states its outcome before you sign. No API key.
Pay-per-call (x402/USDC-Base) web + crypto data tools for AI agents: audit, extract, crypto, DeFi.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceUniversal AI gateway that enables interaction with Ethereum blockchain through natural language across multiple AI platforms (Claude, ChatGPT, Gemini, etc.). Supports contract deployment, token operations, NFT minting, DeFi operations, and general blockchain transactions.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query on-chain data across EVM chains like Base, Optimism, Avalanche, Celo, and Arbitrum, including balances, transactions, gas, and smart contract interactions.53 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to list, search, create, update, mark used, and delete vouchers, coupons, gift cards, and loyalty cards via a token-authenticated JSON API.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying blockchains across EVM, Solana, Bitcoin/UTXO, and Cosmos through a unified interface, with tools for resolving addresses, checking balances, fetching transactions and blocks, reading contracts, decoding calldata, and building unsigned transfers.11 npm3MIT