Solana Token Distribution System for Personnel Compensation

This Model Context Protocol (MCP) server acts as an enterprise-grade mechanism for Human Resources divisions to conduct efficient, blockchain-based payouts using the Solana ecosystem. It standardizes the process of delivering native or custom tokens to designated employee cryptocurrency holdings, incorporating granular control via role assignment and automated outbound messaging.

Core Functionalities

• Cryptocurrency Key Management: Interface with existing Solana key pairs or provision new, secure Crossmint managed wallets.
• Native Asset Minting: Capability to instantiate novel digital assets (tokens) on the Solana ledger.
• Market Depth Provisioning: Automated deployment of initial capital reserves for the newly minted asset via the Raydium Automated Market Maker (AMM).
• Fiduciary Wallet Issuance: Programmatic creation of Crossmint custodial accounts for staff members.
• Data Ingestion: Secure parsing of personnel records via Comma Separated Values (CSV) files, containing identifiers like name, contact, and designation.
• Hierarchical Distribution Logic: Enforcing token dispersal amounts strictly according to predefined staff roles.
• Transactional Cost Prediction: Pre-computation of necessary SOL for network transaction overhead (gas).
• Scalable Payout Mechanism: Utilization of ZK light protocols for highly efficient, compressed ledger updates during mass distribution.
• Stakeholder Communication: Automatic dispatch of instructional correspondence detailing how recipients can claim their allocated assets.

System Requirements

• Runtime Environment: Node.js (version 16 or newer)
• Package Manager: pnpm
• Funding Source: A functional Solana wallet provisioned with requisite SOL for operational expenditures.
• Credential 1: Valid Crossmint Developer Key for custodial service interaction.
• Credential 2: Resend Service Key for transactional email delivery.
• Credential 3: Helius Access Key (Optional, required only for compressed ledger transactions).

Deployment Procedure

Step 1: Repository Acquisition and Initialization

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

This initialization script handles: - Dependency resolution and installation - Cloning secondary required repositories - Generating a base configuration file (.env) - Compiling the project source code

Step 2: Environment Configuration Finalization

Populate the .env configuration file with your organizational credentials:

Crossmint API Credential (Mandatory for wallet provisioning)

CROSSMINT_API_KEY=your_crossmint_api_key

Crossmint Service Email (Mandatory for wallet-related correspondence)

CROSSMINT_EMAIL=your_email@example.com

Resend Transactional Email Key (Mandatory for HR notifications)

RESEND_API_KEY=your_resend_api_key

Helius Key (Optional, for ZK-compressed transfers)

HELIUS_API_KEY=your_helius_api_key

Solana Blockchain Endpoint (Defaults to mainnet-beta)

SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

Step 3: MCP Integration into Runtime Environment

bash pnpm install-mcp

This command registers the utility module with the Claude Desktop environment. A subsequent restart of the host application is required for module activation.

Operational Workflow Guide

Upon successful configuration, users can direct the HR Airdrop MCP server via natural language prompts within Claude Desktop, following this logical sequence:

1. Establish connection to a designated Solana or Crossmint key pair.
2. Define and mint the compensation token.
3. Capitalize the token pool by providing initial market liquidity.
4. Provision segregated digital wallets for all recipients.
5. Ingest and validate the CSV data containing employee entitlements.
6. Calculate the precise token quantity for each individual.
7. Forecast the necessary on-chain operational expenditure.
8. Execute the bulk token transfer.
9. Trigger the delivery of claimant access emails.

Exported Interface Routines

• connect_wallet: Authenticate with a standard Solana private key.
• connect_crossmint_wallet: Authenticate via the Crossmint abstraction layer.
• check_balance: Query the SOL reserve of the operational account.
• create_token: Deploy a new fungible asset standard.
• add_liquidity: Seed the Raydium pool for the new asset.
• generate_wallets: Initiate Crossmint wallet creation for the employee roster.
• upload_csv: Ingest and map personnel data records.
• calculate_amounts: Determine per-employee token allotment schedules.
• calculate_fees: Estimate network transaction costs.
• start_airdrop: Initiate the final distribution transaction batch.
• send_emails: Dispatch claim instructions to personnel.
• get_state: Retrieve the current status of the ongoing distribution cycle.

Data Specification (CSV)

For role-based distribution mapping, the input file must adhere to this structure:

name,email,role John Doe,john@example.com,developer Jane Smith,jane@example.com,manager

Supported Hierarchical Designations: operational, developer, manager, VP, VIP

Maintenance and Contribution

To modify system behavior:

1. Edit the source code within the src/ directory.
2. Recompile the package using pnpm build.
3. Update any relevant metadata or tooling instructions in the host environment if structural changes occurred.

Licensing

This software is distributed under the terms of the MIT License (refer to the LICENSE file).

Attribution

• Framework utilized: Model Context Protocol
• Core Solana interaction: @solana/web3.js library
• Wallet Servicing: Crossmint SDK
• Wallet Abstraction Layer: GOAT SDK for Solana credential interfacing.