Enterprise Staff Token Distribution Framework

This Model Context Protocol (MCP) server is engineered to assist corporate Human Resources departments in executing airdrops of native Solana tokens to their employee base. The system offers an optimized mechanism for transferring digital assets to designated employee crypto addresses, incorporating support for tiered, role-specific entitlements and automated communication triggers.

Core Functionalities

• Digital Wallet Interfacing: Establish secure connections with either standard Solana keypairs or Crossmint-managed wallets to authorize and finalize on-chain transfers.
• Native Asset Minting: Procedure for fabricating novel, custom fungible tokens directly on the Solana ledger.
• Market Depth Provisioning: Mechanism to inject initial trading capital (liquidity) into newly created tokens via the Raydium Automated Market Maker (AMM).
• Managed Wallet Origination: Provisioning of Crossmint non-custodial wallets for employees.
• Spreadsheet Ingestion: Capability to import bulk employee records containing identifiers (name), contact (email), and organizational status (role).
• Entitlement Stratification: Dissemination of tokens governed by predefined organizational seniority or function categories.
• Computational Fee Forecasting: Accurate projection of network transaction overheads prior to initiating the bulk transfer operation.
• Efficient Transfer Protocol: Utilization of ZK Light Protocol constructs for minimized transaction footprints during mass distribution.
• Recipient Communication: Automated dispatch of advisories informing staff on how to redeem their newly allocated digital assets.

System Prerequisites

• Runtime Environment: Node.js (version 16 or newer)
• Package Manager: pnpm
• Funding Source: A configured Solana wallet containing sufficient SOL for covering network computational costs.
• Third-Party Credentials: Crossmint API credential set (essential for custodial wallet bootstrapping).
• Notification Service: Resend API key (required for outbound email services).
• Auxiliary Data Stream: Helius API credential (optional, needed exclusively for leveraging compressed transaction methods).

Deployment Sequence

1. Repository Acquisition and Initialization

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

The execution of setup.sh will automatically: - Resolve and fetch all project dependencies. - Incorporate necessary ancillary repositories. - Generate a boilerplate .env configuration file. - Compile the source code assets.

2. Environment Parameter Configuration

Modify the generated .env file to integrate your requisite API identifiers and operational settings:

Crossmint Authorization Token (mandatory for managed wallet provisioning)

CROSSMINT_API_KEY=your_crossmint_api_key

Crossmint Operational Email (required for associated wallet transactions)

CROSSMINT_EMAIL=your_email@example.com

Resend Service Credential (for transactional email delivery)

RESEND_API_KEY=your_resend_api_key

Helius Endpoint Key (optional; needed only for compressed ledger operations)

HELIUS_API_KEY=your_helius_api_key

Solana Network Access Point (optional; defaults to the mainnet-beta cluster)

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

3. Integration into the Host Environment

bash pnpm install-mcp

This command archives the MCP server instance into the local Claude Desktop runtime environment. A subsequent restart of the Claude Desktop application is necessary to fully load the newly integrated server module.

Operational Workflow Instructions

Upon successful configuration, the HR Airdrop MCP server can be invoked via Claude Desktop by issuing sequential commands such as:

1. Establish connection to a Solana or Crossmint holding account.
2. Initiate the creation process for an employee incentive token.
3. Seed market depth for the new token.
4. Provision managed wallets for the recipient cohort.
5. Ingest the structured employee data from the uploaded spreadsheet.
6. Determine precise per-employee token allotments.
7. Compute the requisite network transfer overheads.
8. Execute the bulk token dispersal operation.
9. Dispatch confirmation and access instructions via electronic mail.

Accessible Command Interface

• connect_wallet: Authenticate a direct Solana keypair.
• connect_crossmint_wallet: Authenticate a Crossmint custodial account.
• check_balance: Query the SOL reserve balance of the connected wallet.
• create_token: Deploy a new token contract.
• add_liquidity: Bootstrap trading pool for the token.
• generate_wallets: Provision employee-specific managed wallets.
• upload_csv: Parse and validate employee data from CSV input.
• calculate_amounts: Compute the final token distribution schedule.
• calculate_fees: Estimate total Solana transaction costs.
• start_airdrop: Trigger the token distribution transaction.
• send_emails: Dispatch employee notification correspondence.
• get_state: Retrieve the current status metadata of the ongoing distribution.

Data Structure Specification (CSV)

For entitlements segmented by professional function, the input spreadsheet must adhere to the following field structure:

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

Permitted role designations for allocation logic: operational, developer, manager, VP, VIP.

Development Notes

To implement modifications or enhancements to the codebase:

1. Edit the source code modules located within the src/ directory.
2. Recompile the project using the command: pnpm build.
3. Update any relevant configurations within the Claude Desktop environment if necessary.

Licensing

This software is distributed under the terms of the MIT License (refer to the accompanying LICENSE file for complete legal stipulations).

Acknowledgments

• Framework utilized: Model Context Protocol
• Core Blockchain Library: @solana/web3.js
• Custodial Wallet Abstraction: Crossmint SDK
• Solana Wallet Interoperability: GOAT SDK