Skip to main content

Rename "subscription" tools/fields to "recurring payment" to match the app UI

Hi!

In the app UI this feature is called "Recurring payments", but the MCP tools and API fields still use "subscription". This mismatch causes confusion for the assistant and, through it, for users.

Problem

  • The feature covers bills, subscriptions, installment plans and recurring income (the records have type "bill", etc.). "Subscription" suggests only streaming/app-style services.

  • Concrete case: an assistant called get_subscriptions_summary and reported "$529/month in subscriptions" and suggested auditing them. The records were rent ($500), a phone bill and a tax payment, so the advice was misleading. The tool and field names (estimatedMonthlyCost, activeCount, percentOfIncome) all reinforce the "subscription" framing.

  • Users see "Recurring payments" in the app but "subscription" in assistant answers, which looks like two different features.

Proposal Rename tools and related fields/descriptions to "recurring payment": get_subscriptions -> get_recurring_payments get_subscription_by_id -> get_recurring_payment_by_id get_subscription_periods -> get_recurring_payment_periods get_subscriptions_summary -> get_recurring_payments_summary create_subscription -> create_recurring_payment update_subscription -> update_recurring_payment delete_subscription -> delete_recurring_payment toggle_subscription_active -> toggle_recurring_payment_active pay_subscription_period -> pay_recurring_payment_period skip_subscription_period -> skip_recurring_payment_period revert_subscription_period -> revert_recurring_payment_period preview_subscription_payment -> preview_recurring_payment link_transactions_to_subscription -> link_transactions_to_recurring_payment unlink_transactions_from_subscription -> unlink_transactions_from_recurring_payment unlink_subscription_period_transaction -> unlink_recurring_payment_period_transaction get_upcoming_subscription_payments -> get_upcoming_recurring_payments detect_subscription_candidates -> detect_recurring_payment_candidates list_subscription_candidates -> list_recurring_payment_candidates accept_subscription_candidate -> accept_recurring_payment_candidate dismiss_subscription_candidate -> dismiss_recurring_payment_candidate list_subscription_match_suggestions -> list_recurring_payment_match_suggestions

Thanks!

Log in to comment and vote

No comments yet

Be the first to share your thoughts.