connect_crossmint_wallet

Instructions

Implementation Reference

• src/server.ts:359-452 (handler)

  Main handler function for 'connect_crossmint_wallet' tool. Validates input with Zod, initializes Crossmint client with API key, retrieves custodial Solana wallet for the given email, extracts public key and sets default SOL balance, updates server state with connected wallet info. Includes fallback to simulation mode on connection error and prompts for API key if missing.

    private async handleConnectCrossmintWallet(args: any) {
      try {
        // Validate input
        const schema = z.object({
          email: z.string().email(),
          apiKey: z.string().optional(),
        });
        
        const { email, apiKey: providedApiKey } = schema.parse(args);
        
        // Check if API key is provided, if not, prompt the user
        if (!providedApiKey) {
          return {
            content: [
              {
                type: 'text',
                text: `To connect a Crossmint wallet, I need your Crossmint API key. You can get this from the Crossmint developer dashboard at https://www.crossmint.com/
  
  Please provide your Crossmint API key to continue.`,
              },
            ],
          };
        }
        
        const apiKey = providedApiKey;
        
        console.error(`Connecting Crossmint wallet for ${email}`);
        
        try {
          // In production mode, attempt to connect to the real Crossmint wallet
          console.error('PRODUCTION MODE: Attempting to connect to real Crossmint wallet');
          
          // Initialize Crossmint client
          const crossmintClient = crossmint(apiKey);
          
          // Get the wallet for this email
          const wallet = await crossmintClient.custodial({
            chain: "solana",
            connection: new Connection('https://api.mainnet-beta.solana.com', 'confirmed'),
            email
          });
          
          // Get the wallet address
          const publicKey = wallet.getAddress();
          
          // Get the SOL balance (in a real implementation, we would query the blockchain)
          // For now, we'll use a default value
          const solBalance = 1.0;
          
          console.error(`Successfully connected to real Crossmint wallet: ${publicKey}`);
          
          // Update state
          this.state.connectedWallet = {
            publicKey,
            solBalance,
          };
          
          return {
            content: [
              {
                type: 'text',
                text: `Crossmint wallet connected successfully for ${email}.\nPublic Key: ${publicKey}\nSOL Balance: ${solBalance} SOL`,
              },
            ],
          };
        } catch (error) {
          console.error('Error connecting to real Crossmint wallet, falling back to simulation:', error);
          
          // Generate a pseudo-random wallet address
          const publicKey = `crossmint_${Math.random().toString(36).substring(2, 10)}`;
          const solBalance = 1.0; // Default SOL balance for demo
          
          // Update state
          this.state.connectedWallet = {
            publicKey,
            solBalance,
          };
          
          return {
            content: [
              {
                type: 'text',
                text: `Crossmint wallet connected successfully for ${email}.\nPublic Key: ${publicKey}\nSOL Balance: ${solBalance} SOL\n\n(Note: Using simulation mode due to connection error)`,
              },
            ],
          };
        }
      } catch (error) {
        throw new McpError(
          ErrorCode.InternalError,
          `Failed to connect Crossmint wallet: ${error instanceof Error ? error.message : String(error)}`
        );
      }
    }

• src/server.ts:134-150 (registration)

  Tool registration in ListToolsRequestSchema handler, including name, description, and input schema requiring 'email' and 'apiKey'.

    name: 'connect_crossmint_wallet',
    description: 'Connect a Crossmint wallet to the airdrop server',
    inputSchema: {
      type: 'object',
      properties: {
        email: {
          type: 'string',
          description: 'Email address associated with the Crossmint wallet',
        },
        apiKey: {
          type: 'string',
          description: 'Crossmint API key',
        },
      },
      required: ['email', 'apiKey'],
    },
  },

• src/server.ts:362-365 (schema)

  Zod schema for input validation inside the handler, requiring valid email and optional apiKey.

  const schema = z.object({
    email: z.string().email(),
    apiKey: z.string().optional(),
  });

• src/server.ts:316-317 (registration)

  Dispatch case in CallToolRequestSchema switch statement that routes to the handler function.

  case 'connect_crossmint_wallet':
    return await this.handleConnectCrossmintWallet(args);