Employees Airdrop Rewards MCP

🚀 CrossMint Human Resources Airdrop MCP

A Model Context Protocol (MCP) server that helps corporate HR teams airdrop Solana tokens to employees. This project provides an efficient way to distribute tokens to employees' wallet addresses, supports role-based allocation, and automates email notifications.

🚀 Quick Start

After the project is built, you can follow these steps:

1. Initialize Configuration: Edit the configuration file and fill in relevant information.
2. Import Employee Data: Upload a CSV file containing employee information.
3. Set Token Parameters: Specify the tokens to be distributed and their allocation rules.
4. Execute Airdrop: Run the script to start the token distribution process.
5. Monitor Progress: Track the distribution status through the provided console or logs.

✨ Features

• Wallet Management: Connect Solana or Crossmint wallets to sign and fund transactions.
• Token Creation: Create custom tokens on the Solana blockchain.
• Liquidity Management: Add liquidity for new tokens via Raydium AMM.
• Managed Wallet Generation: Create Crossmint managed wallets for employees.
• CSV Import: Upload employee data with names, emails, and roles.
• Role-based Allocation: Allocate tokens according to employee roles.
• Gas Fee Estimation: Calculate transaction fees before airdrops.
• Compressed Airdrop: Use zero-knowledge lightweight protocol for efficient token distribution.
• Email Notification: Send instructions for employees to access their tokens.

📦 Installation

1. Clone and Setup

git clone https://github.com/monostate/Employees-Airdrop-Rewards-MCP.git
cd crossmint-hr-airdrop-mcp
./setup.sh

The installation script will:

• Install dependencies.
• Clone required repositories.
• Create a .env file template.
• Build the project.

2. Configure Environment Variables

Edit the .env file and fill it with your API keys and configurations:

# CrossMint API Key (Required for managed wallet creation)
CROSSMINT_API_KEY=your_crossmint_api_key

# CrossMint Email (For wallet operations)
CROSSMINT_EMAIL=your_email@example.com

# Resend API Key (Required for sending emails)
RESEND_API_KEY=your_resend_api_key

# Helius API Key (Optional, for compressed transactions)
HELIUS_API_KEY=your_helius_api_key

# Solana RPC URL (Optional, defaults to Mainnet Beta)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

3. Install to Claude Desktop

pnpm install-mc

💻 Usage Examples

Basic Usage

After completing the installation and configuration, you can start the token airdrop process. First, ensure that your configuration file is correctly filled with all necessary information. Then, import the employee data CSV file and set the token parameters. Finally, run the airdrop script.

# Assume there is a script named airdrop.sh to start the airdrop
./airdrop.sh

📚 Documentation

Prerequisites

• Node.js (v16+)
• pnpm package manager
• A Solana wallet with SOL for transaction fees
• CrossMint API key for managed wallet creation
• Resend API key for sending emails
• Helius API key (optional, for compressed transactions)

CSV Format

The employee data file should contain the following fields:

Development Information

• Project Repository: GitHub
• Issue Reporting: Issues

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

Acknowledgments

Thanks to the support of the following projects and technologies:

• Solana blockchain
• CrossMint wallet
• Raydium AMM
• pnpm package manager