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:

```