Money Manager MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:549-576 (handler)

  The handleCardCreate function implements the core logic for the card_create tool. It validates the input using CardCreateInputSchema, sends a POST request to the '/addAssetCard' endpoint with the card details, and returns a CardOperationResponse indicating success and the new card ID.

  /**
   * Handler for card_create tool
   * Creates a new credit card
   */
  export async function handleCardCreate(
    httpClient: HttpClient,
    input: unknown,
  ): Promise<CardOperationResponse> {
    const validated = CardCreateInputSchema.parse(input);
  
    const response = await httpClient.post<ApiOperationResponse>(
      "/addAssetCard",
      {
        cardName: validated.cardName,
        linkAssetId: validated.linkAssetId,
        linkAssetName: validated.linkAssetName,
        notPayMoney: validated.notPayMoney,
        jungsanDay: validated.jungsanDay,
        paymentDay: validated.paymentDay,
      },
    );
  
    return {
      success: response.success !== false && response.result !== "fail",
      cardId: response.cardId || response.assetId,
      message: response.message,
    };
  }

• src/schemas/index.ts:256-268 (schema)

  Zod schema defining the input parameters for the card_create tool, including validation rules for card name, linked asset, unpaid balance, and optional settlement/payment days. Also exports the inferred TypeScript type.

  /**
   * Input schema for card_create tool
   */
  export const CardCreateInputSchema = z.object({
    cardName: NonEmptyString,
    linkAssetId: AssetIdSchema,
    linkAssetName: NonEmptyString,
    notPayMoney: z.number(),
    jungsanDay: DayOfMonthSchema.optional(),
    paymentDay: DayOfMonthSchema.optional(),
  });
  
  export type CardCreateInput = z.infer<typeof CardCreateInputSchema>;

• src/index.ts:296-322 (registration)

  MCP tool registration in TOOL_DEFINITIONS array: defines the 'card_create' tool with name, description, and JSON schema for input validation, used by the MCP server's list_tools handler.

  {
    name: "card_create",
    description: "Creates a new credit card.",
    inputSchema: {
      type: "object" as const,
      properties: {
        cardName: { type: "string", description: "Credit card name" },
        linkAssetId: { type: "string", description: "Linked payment asset ID" },
        linkAssetName: {
          type: "string",
          description: "Linked payment asset name",
        },
        notPayMoney: {
          type: "number",
          description: "Unpaid balance (negative value)",
        },
        jungsanDay: {
          type: "number",
          description: "Optional: Balance calculation day (1-31)",
        },
        paymentDay: {
          type: "number",
          description: "Optional: Payment due day (1-31)",
        },
      },
      required: ["cardName", "linkAssetId", "linkAssetName", "notPayMoney"],
    },

• src/tools/handlers.ts:813-815 (registration)

  Internal registration mapping 'card_create' string key to the handleCardCreate handler function within the toolHandlers object, used by executeToolHandler to dispatch calls.

  card_list: handleCardList,
  card_create: handleCardCreate,
  card_update: handleCardUpdate,