wallos-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WALLOS_URL | Yes | Your Wallos instance URL, e.g. https://wallos.example.com, http://192.168.1.10:8282, or https://example.com/wallos (flag: --url) | |
| WALLOS_API_KEY | Yes | Your Wallos API key from Profile → API Key (flag: --api-key) | |
| WALLOS_READ_ONLY | No | Register no tool that can change anything (flag: --read-only) | false |
| WALLOS_TIMEOUT_MS | No | Per-request timeout in milliseconds (flag: --timeout) | 30000 |
| WALLOS_INSECURE_TLS | No | Accept a self-signed certificate (flag: --insecure-tls) | false |
| WALLOS_ENABLE_ADMIN_TOOLS | No | Add 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
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.
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.
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.
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.