What is Employees Airdrop Rewards Mcp

Employees-Airdrop-Rewards-MCP is a Model Context Protocol (MCP) server designed to assist corporate HR teams in distributing Solana tokens to employees. It streamlines the process of airdropping tokens to employee wallet addresses, featuring role-based allocation and automated email notifications.

Use cases

Use cases for Employees-Airdrop-Rewards-MCP include distributing rewards to employees based on their roles, managing employee incentives in a decentralized manner, facilitating employee engagement through token-based rewards, and enhancing corporate loyalty programs.

How to use

To use Employees-Airdrop-Rewards-MCP, set up the server by cloning the repository, configuring environment variables with your API keys, and installing the necessary packages. Once configured, connect a Solana or Crossmint wallet, create tokens, manage liquidity, upload employee data via CSV, and initiate the airdrop process while sending email notifications.

Key features

Key features include wallet management for Solana and Crossmint wallets, custom token creation on the Solana blockchain, liquidity management via Raydium AMM, custodial wallet generation for employees, CSV import for employee data, role-based token allocation, gas fee estimation, compressed airdrops using ZK light protocol, and automated email notifications.

Where to use

Employees-Airdrop-Rewards-MCP can be utilized in corporate environments, particularly within HR departments that aim to incentivize employees through token rewards. It is applicable in organizations looking to integrate blockchain technology into their reward systems.

Crossmint HR Airdrop MCP

A Model Context Protocol (MCP) server to help corporate HR teams airdrop Solana tokens to employees. This project provides an efficient way to distribute tokens to employee wallet addresses, with support for role-based allocation and automated email notifications.

Features

• Wallet Management: Connect a Solana wallet or Crossmint wallet to sign and fund transactions
• Token Creation: Create custom tokens on the Solana blockchain
• Liquidity Management: Add liquidity to new tokens via Raydium AMM
• Custodial Wallet Generation: Create Crossmint custodial wallets for employees
• CSV Import: Upload employee data with name, email, and role information
• Role-Based Allocation: Distribute tokens based on employee roles
• Gas Fee Estimation: Calculate transaction fees before airdrop
• Compressed Airdrops: Use ZK light protocol for efficient token distribution
• Email Notifications: Send employees instructions to access their tokens

Prerequisites

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

Installation

1. Clone and Setup

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

The setup script will:

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

2. Configure Environment Variables

Edit the .env file with your API keys and configuration:

# Crossmint API Key (required for custodial wallet creation)
CROSSMINT_API_KEY=your_crossmint_api_key

# Crossmint Email (required for wallet operations)
[email protected]

# 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-mcp

This will install the MCP server to Claude Desktop. You’ll need to restart Claude Desktop to load the new MCP server.

Usage Guide

Once configured, you can use the HR Airdrop MCP server with Claude Desktop by giving it instructions like:

1. Connect a Solana wallet or Crossmint wallet
2. Create a token for employee rewards
3. Add liquidity to the token
4. Generate custodial wallets for employees
5. Upload a CSV with employee roles
6. Calculate token distribution
7. Calculate gas fees
8. Perform the airdrop
9. Send notification emails

Available Tools

• connect_wallet: Connect a Solana wallet
• connect_crossmint_wallet: Connect a Crossmint wallet
• check_balance: Check wallet SOL balance
• create_token: Create a new token
• add_liquidity: Add liquidity to the token
• generate_wallets: Create custodial wallets for employees
• upload_csv: Process employee data from CSV
• calculate_amounts: Calculate token distribution amounts
• calculate_fees: Calculate gas fees for the airdrop
• start_airdrop: Perform the token airdrop
• send_emails: Send notifications to employees
• get_state: Check the current state of the airdrop process

CSV Format

For role-based token distribution, prepare a CSV file with the following columns:

name,email,role
John Doe,[email protected],developer
Jane Smith,[email protected],manager

Supported roles: operational, developer, manager, VP, VIP

Development

To make changes to the project:

1. Modify the TypeScript files in src/
2. Rebuild with pnpm build
3. Update your Claude Desktop configuration if needed

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with the Model Context Protocol
• Uses the @solana/web3.js library
• Uses the Crossmint SDK for wallet management
• Uses the GOAT SDK for Solana wallet integration