UniVoucher

Queries and creates UniVoucher gift cards via MCP, with read-only and wallet-enabled modes across multiple blockchains.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

UniVoucher MCP Server lets you manage and interact with the UniVoucher crypto gift card protocol directly from your MCP client. It supports creating and querying gift cards across multiple blockchains, with optional private-key-enabled operations for card creation and management, all while keeping private keys local to your environment.

How to use

You integrate UniVoucher MCP Server into your MCP client by adding its configuration. Use read-only access to list and query cards, protocol statistics, and supported networks. If you need to create or modify gift cards, provide your wallet private key to enable full access, including card creation. Your private key remains local to your environment and is not stored by the service.

How to install

Prerequisites: make sure you have Node.js and npm installed on your machine.

Add the basic configuration to your MCP client to use UniVoucher in read-only mode.

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

If you want full access (including card creation), add the WALLET_PRIVATE_KEY as an environment variable.

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

Optional security note: never commit your wallet private key to version control. Use environment variables or secure configuration management.
You can also install UniVoucher MCP Server globally or by a specific version.

npm install -g univoucher-mcp@latest
`

npm install univoucher-mcp@1.3.4
`

After installation, reference the server by its MCP command in your client configuration, e.g., using the global univoucher-mcp binary or the npx invocation shown above.

Additional notes

Supported networks include Ethereum, Base, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, and more. You can work with native currency or ERC-20 tokens, and bulk gift card creation is supported.

Package managers mentioned: npm and npx. The server is designed to work with MCP clients that support the standard MCP configuration flow.

Security and privacy are handled locally for private keys. Ensure that your environment is secure and that only trusted clients have access to the private key in memory.

For read-only operations, you can omit the private key entirely and still query the protocol state, fees, and supported networks.

Tools and capabilities

The server exposes a set of tools to query and manage the UniVoucher protocol through the MCP interface. These include listing and retrieving documentation pages, querying cards, and performing gift card operations.

Available tools

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