Skip to main content
Glama
wallos-mcp

wallos-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WALLOS_URLYesYour Wallos instance URL, e.g. https://wallos.example.com, http://192.168.1.10:8282, or https://example.com/wallos (flag: --url)
WALLOS_API_KEYYesYour Wallos API key from Profile → API Key (flag: --api-key)
WALLOS_READ_ONLYNoRegister no tool that can change anything (flag: --read-only)false
WALLOS_TIMEOUT_MSNoPer-request timeout in milliseconds (flag: --timeout)30000
WALLOS_INSECURE_TLSNoAccept a self-signed certificate (flag: --insecure-tls)false
WALLOS_ENABLE_ADMIN_TOOLSNoAdd the five instance-wide admin tools (flag: --admin-tools)false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_subscriptionsA

Lists the subscriptions in this Wallos account with their price, billing period and next payment date. Filters accept names or ids. This is the tool to reach for when asked what someone pays for, what is due, or what a category or person costs.

get_subscriptionA

Reads a single subscription by id, including its category, payer and payment method names.

create_subscriptionA

Adds a subscription. Only a name and a price are required: the billing period defaults to monthly, the start date to today, the next payment date is derived from the start date, and the currency to the account’s main one. Categories, payment methods and household members named here are created when missing, so "category: Entertainment" works on a fresh instance.

update_subscriptionA

Changes fields on an existing subscription. Only the fields you pass are touched, everything else is left as it was. Pass null to clear a field such as category, payer or notes.

delete_subscriptionA

Permanently removes a subscription from Wallos. There is no undo, so confirm the id first with list_subscriptions. To stop paying for something but keep the history, prefer setting inactive: true instead.

get_monthly_costA

Total spend for a calendar month, converted into the main currency, as Wallos computes it on the dashboard. Defaults to the current month.

get_period_budgetA

How the current budget period is going: what the budget is, what this period is projected to cost, and how much is left or over. Defaults to the period containing today.

get_ical_feedA

The same calendar feed Wallos serves for subscribing in a calendar app: one all-day event per upcoming payment, as an iCalendar document. Useful when someone wants the raw export rather than a summary.

get_master_dataA

Everything a subscription can point at, in one call: categories, currencies with the main one flagged, payment methods and household members, each with its id. Call this before changing a subscription so the names you pass are real, and to answer questions about how someone organises their spending.

manage_categoryA

Adds, renames or deletes a spending category. Wallos refuses to delete a category that subscriptions still use, and will name the ones in the way.

manage_currencyA

Adds, edits or deletes a currency on the account. A currency needs a name, a symbol and an ISO code, and its rate is relative to the main currency. Wallos refuses to delete one that subscriptions still use.

manage_payment_methodA

Adds, renames, enables, disables or deletes a payment method. Wallos refuses to delete one that subscriptions still use.

manage_householdA

Adds, edits or deletes a household member. Members are who subscriptions are attributed to, not login accounts. Wallos refuses to delete a member that subscriptions are still attributed to.

get_accountA

Who the configured API key belongs to, what the main currency, language and budgets are, and which version of Wallos is running. A good first call to understand the account you are working with.

get_settingsB

The account’s display preferences: theme, currency conversion, how subscriptions are ordered and hidden on the dashboard, and any custom CSS.

update_settingsA

Changes display settings. Only the settings you pass are changed; everything else keeps its current value.

get_notification_settingsA

Which notification channels this account has set up (email, Discord, Gotify, ntfy, Pushover, Telegram, webhook, ServerChan), how many days ahead reminders go out, and whether each is enabled. Wallos masks the credentials.

get_fixer_settingsB

Which exchange rate provider is configured and whether an API key is present. Rates are what make multi-currency totals possible.

update_fixer_settingsA

Sets the exchange rate provider, and the API key for Fixer.io or APILayer. Frankfurter needs no key.

update_budgetC

Sets the monthly budget, or the budget for a rolling period such as weekly, fortnightly or monthly, with an anchor date that decides where periods begin.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 20 tools

Disambiguation4/5

Subscription CRUD tools are clearly separated and the four manage_* tools each target a distinct entity (category, currency, payment method, household). Some mild conceptual overlap exists between get_monthly_cost and get_period_budget, and get_master_data partially duplicates what get_subscription/get_account expose, but descriptions clarify the intended use.

Naming Consistency5/5

Uniform verb_noun snake_case throughout (list_subscriptions, get_subscription, create_subscription, update_settings, manage_category). The manage_* family is a consistent convention for the multi-entity resources, not an inconsistency.

Tool Count4/5

20 tools is on the heavy side but justified by the breadth of the domain (subscriptions, categories, currencies, payment methods, household, budgets, settings, notifications, exchange rates, iCal). Each tool maps to a real resource or operation rather than redundancy.

Completeness4/5

Subscription lifecycle and master data are fully covered, with settings and exchange-rate configuration having read/update pairs. The main gap is notification settings being read-only (get_notification_settings with no update counterpart), plus budget visibility only indirect via get_period_budget/get_account.

Maintenance

ActivitySlowing
ResponsivenessNo recent community issues