Employees Airdrop Rewards MCP

0 forks

0 stars

Free

What is Employees-Airdrop-Rewards-MCP

Employees-Airdrop-Rewards-MCP is an innovative Model Context Protocol (MCP) server designed by monostate to facilitate the distribution of Solana tokens to employees. This server is an essential tool for corporate HR teams looking to efficiently manage and execute token airdrops to employee wallet addresses. It supports role-based token allocation and automates email notifications to ensure that employees receive their tokens promptly and securely.

How to Use Employees-Airdrop-Rewards-MCP

Using the Employees-Airdrop-Rewards-MCP involves several straightforward steps:

Setup and Configuration: Begin by installing the server software, which requires Node.js, the pnpm package manager, and a Solana wallet. You will also need API keys for Crossmint and Resend for wallet creation and email notifications, respectively.
Connect Wallets: Use the server to connect either a Solana wallet or a Crossmint wallet, which will be used for signing and funding transactions.
Create Tokens: Generate custom tokens on the Solana blockchain intended for employee rewards.
Liquidity Management: Add liquidity to the newly created tokens using the Raydium AMM to ensure they are trade-ready.
Generate Custodial Wallets: For employees, generate Crossmint custodial wallets to manage and store their tokens securely.
CSV Import: Upload a CSV file containing employee details such as name, email, and role, which facilitates role-based token distribution.
Calculate and Execute Airdrop: Calculate the distribution amounts based on roles, estimate transaction fees, and execute the airdrop using the efficient ZK light protocol for compressed token distribution.
Notify Employees: Automatically send email notifications to employees with instructions on how to access their tokens.

Key Features of Employees-Airdrop-Rewards-MCP

Wallet Management: Easily connect and manage Solana and Crossmint wallets to facilitate transactions.
Token Creation: Seamlessly create and manage tokens on the Solana blockchain.
Liquidity Management: Enhance token usability by adding liquidity through Raydium AMM.
Custodial Wallet Generation: Automatically generate secure Crossmint custodial wallets for employees.
CSV Import for Role-Based Allocation: Simplify token distribution by uploading employee data in a CSV format, enabling automated role-based token allocation.
Gas Fee Estimation: Accurately estimate transaction fees before executing the airdrop to manage costs effectively.
Compressed Airdrops: Utilize ZK light protocol for efficient and fast token distribution.
Automated Email Notifications: Keep employees informed with automated emails detailing how to access their tokens.

Employees-Airdrop-Rewards-MCP provides a comprehensive solution for HR teams to distribute blockchain-based rewards efficiently and securely, ensuring seamless integration with existing corporate processes.

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 
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=

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 IYHeE1GSOf4ow3i3-generated_image

How to Use

To use the Employees-Airdrop-Rewards-MCP, follow these steps:

Visit https://github.com/monostate/Employees-Airdrop-Rewards-MCPhttps://github.com/monost...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using Employees-Airdrop-Rewards-MCP capabilities within your Claude conversations

Additional Information

Created

March 15, 2025

Company

monostate

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More