shelter-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Local HTTP port. Defaults to 3100. | |
| SHELTER_API_KEY | Yes | Scoped key created in Shelter. Keep it secret. | |
| SHELTER_API_URL | No | API base URL. Defaults to https://api.shelter.money/agent. |
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
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| shelter_statusA | Get a snapshot of your financial status — safe-to-spend, balances, upcoming bills, health score. |
| shelter_runwayA | How many days until you run out of money — daily budget, next payday, safe-to-spend. |
| shelter_forecastA | Verified 14-day view of Shelter's canonical 30-day balance forecast. |
| shelter_alertsA | Get active financial alerts — unusual spending, upcoming bills, low balance warnings. |
| shelter_opportunitiesA | Find savings opportunities — unused subscriptions, negotiable bills, spending patterns to optimize. |
| shelter_contextA | Get a natural-language summary of the user's financial situation for use as conversation context. |
| shelter_affordabilityA | Check if you can afford a specific purchase — impact on safe-to-spend, recommendation. |
| shelter_coach_dailyB | Get today's personalized financial coaching tip based on your recent spending. |
| shelter_coach_adviceA | Get targeted financial advice on a specific topic — debt, savings, bills, subscriptions, or negotiation. |
| shelter_askA | Ask Guardian AI any question about your finances — spending, bills, trends, or advice. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| financial-checkup | Step-by-step financial checkup — review status, alerts, forecast, and opportunities. |
| spending-review | Guide for finding savings opportunities in your spending. |
| plan-a-purchase | Evaluate whether you can afford a purchase and understand the financial impact. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools have distinct purposes: status provides a snapshot, runway focuses on days of money, forecast is a specific projection, alerts, opportunities, context, affordability, coach daily, coach advice, and ask all serve different functions. However, shelter_status and shelter_runway both include safe-to-spend and upcoming bills, and shelter_coach_advice and shelter_ask could be confused for similar advice-seeking, creating minor overlap.
All tools follow a consistent pattern: shelter_ + lowercase snake_case noun or noun phrase (e.g., shelter_status, shelter_coach_daily). The prefix is uniformament and the style is identical across the set, making it predictable for an agent.
With 10 tools, the count is well within the optimal range for a personal finance assistant. Each tool covers a distinct aspect of financial status, insights, or advice, and none feel redundant or unnecessary for the stated purpose.
The tool set covers a wide range of read-only financial information: status, forecast, runway, alerts, opportunities, affordability, and coaching. However, it lacks any action-oriented tools (e.g., updating a budget, setting alerts, or initiating transactions), which might be a gap if the server intended to support more than advisory functions. Still, for a likely read-only assistant, the surface is fairly complete.