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
0x0000000000000000000000000000000000000000as 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
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