Money Manager MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:440-464 (handler)

  The main handler function for the asset_create tool. Validates input using AssetCreateInputSchema and makes a POST request to the /assetAdd API endpoint to create a new asset.

  /**
   * Handler for asset_create tool
   * Creates a new asset/account
   */
  export async function handleAssetCreate(
    httpClient: HttpClient,
    input: unknown,
  ): Promise<AssetOperationResponse> {
    const validated = AssetCreateInputSchema.parse(input);
  
    const response = await httpClient.post<ApiOperationResponse>("/assetAdd", {
      assetGroupId: validated.assetGroupId,
      assetGroupName: validated.assetGroupName,
      assetName: validated.assetName,
      assetMoney: validated.assetMoney,
      linkAssetId: validated.linkAssetId || "",
      linkAssetName: validated.linkAssetName || "",
    });
  
    return {
      success: response.success !== false && response.result !== "fail",
      assetId: response.assetId,
      message: response.message,
    };
  }

• src/schemas/index.ts:202-214 (schema)

  Zod schema definition for validating input parameters of the asset_create tool, including assetGroupId, assetGroupName, assetName, assetMoney, and optional link fields.

  /**
   * Input schema for asset_create tool
   */
  export const AssetCreateInputSchema = z.object({
    assetGroupId: NonEmptyString,
    assetGroupName: NonEmptyString,
    assetName: NonEmptyString,
    assetMoney: z.number(),
    linkAssetId: z.string().optional(),
    linkAssetName: z.string().optional(),
  });
  
  export type AssetCreateInput = z.infer<typeof AssetCreateInputSchema>;

• src/index.ts:224-245 (registration)

  MCP tool registration in the TOOL_DEFINITIONS array, defining the name, description, and inputSchema for the asset_create tool.

  {
    name: "asset_create",
    description: "Creates a new asset/account.",
    inputSchema: {
      type: "object" as const,
      properties: {
        assetGroupId: { type: "string", description: "Asset group ID" },
        assetGroupName: { type: "string", description: "Asset group name" },
        assetName: { type: "string", description: "Asset name" },
        assetMoney: { type: "number", description: "Initial balance" },
        linkAssetId: {
          type: "string",
          description: "Optional: Linked asset ID",
        },
        linkAssetName: {
          type: "string",
          description: "Optional: Linked asset name",
        },
      },
      required: ["assetGroupId", "assetGroupName", "assetName", "assetMoney"],
    },
  },

• src/tools/handlers.ts:792-828 (registration)

  Internal tool handler registry mapping 'asset_create' to the handleAssetCreate function.

  export const toolHandlers = {
    // Initialization
    init_get_data: handleInitGetData,
  
    // Transactions
    transaction_list: handleTransactionList,
    transaction_create: handleTransactionCreate,
    transaction_update: handleTransactionUpdate,
    transaction_delete: handleTransactionDelete,
  
    // Summary
    summary_get_period: handleSummaryGetPeriod,
    summary_export_excel: handleSummaryExportExcel,
  
    // Assets
    asset_list: handleAssetList,
    asset_create: handleAssetCreate,
    asset_update: handleAssetUpdate,
    asset_delete: handleAssetDelete,
  
    // Credit Cards
    card_list: handleCardList,
    card_create: handleCardCreate,
    card_update: handleCardUpdate,
  
    // Transfers
    transfer_create: handleTransferCreate,
    transfer_update: handleTransferUpdate,
  
    // Dashboard
    dashboard_get_overview: handleDashboardGetOverview,
    dashboard_get_asset_chart: handleDashboardGetAssetChart,
  
    // Backup
    backup_download: handleBackupDownload,
    backup_restore: handleBackupRestore,
  } as const;

• src/types/index.ts:137-145 (schema)

  TypeScript interface definition for AssetCreateInput used in conjunction with the Zod schema.

   */
  export interface AssetCreateInput {
    assetGroupId: string;
    assetGroupName: string;
    assetName: string;
    assetMoney: number;
    linkAssetId?: string;
    linkAssetName?: string;
  }