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)
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-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:

Connect a Solana wallet or Crossmint wallet
Create a token for employee rewards
Add liquidity to the token
Generate custodial wallets for employees
Upload a CSV with employee roles
Calculate token distribution
Calculate gas fees
Perform the airdrop
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,john@example.com,developer
Jane Smith,jane@example.com,manager

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

Development

To make changes to the project:

Modify the TypeScript files in src/
Rebuild with pnpm build
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

Integrations