Base Network MCP Server

Instructions

Implementation Reference

• src/mcp/tools.ts:111-127 (handler)

  Main handler function for the 'create_wallet' tool. Validates args, calls createWallet helper, formats and returns the response.

  async function handleCreateWallet(args: CreateWalletArgs): Promise<any> {
    try {
      const wallet = createWallet(args.name);
      
      return {
        success: true,
        message: `Created new wallet "${wallet.name}" with address ${wallet.address}`,
        wallet: {
          name: wallet.name,
          address: wallet.address
        }
      };
    } catch (error) {
      console.error('Error creating wallet:', error);
      throw error;
    }
  }

• src/mcp/server.ts:279-292 (registration)

  MCP CallToolRequestSchema handler case that dispatches 'create_wallet' tool calls to handleCreateWallet and returns MCP-formatted response.

  case 'create_wallet': {
    const result = await toolHandlers.handleCreateWallet({
      name: typeof args.name === 'string' ? args.name : undefined,
    });
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/mcp/server.ts:215-226 (registration)

  Tool registration in ListToolsRequestSchema response, defining name, description, and input schema for 'create_wallet'.

    name: 'create_wallet',
    description: 'Create a new wallet',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Optional name for the wallet',
        },
      },
    },
  },

• src/types.ts:62-64 (schema)

  TypeScript interface defining the input arguments for create_wallet tool.

  export interface CreateWalletArgs {
    name?: string; // Optional wallet name
  }

• src/blockchain/wallet.ts:37-56 (helper)

  Core helper function that generates a new wallet using viem, stores it in memory, and returns wallet details.

  export function createWallet(name?: string): Wallet {
    // Generate a random private key
    const privateKey = generatePrivateKey();
    const account = privateKeyToAccount(privateKey);
    
    // Use provided name or generate a random one
    const walletName = name || `wallet_${Object.keys(walletStore).length + 1}`;
    
    // Store the wallet
    const wallet: Wallet = {
      address: account.address,
      privateKey: privateKey,
      name: walletName
    };
    
    walletStore[walletName] = wallet;
    console.log(`Created new wallet: ${wallet.address} with name: ${walletName}`);
    
    return wallet;
  }