Skip to content
MCP server

Shelter

Read-only money forecasts, safe-to-spend and affordability checks from Shelter

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API, Web
Runs
Locally
Version
1.0.7
Listing updated
1 day ago

About Shelter

Shelter is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Shelter's MCP server gives a coding or chat assistant answers computed from your own Shelter account rather than raw bank access. After you link accounts inside Shelter through its read-only Plaid connection, you create a scoped API key, and the assistant can ask what is safe to spend before payday, how many days of runway remain, what the 14-day cash-flow view looks like, which alerts are current, and whether a specific purchase fits without putting a bill at risk.

The README lists ten tools, including daily and topical coaching and a question tool. Everything is read-only: the server cannot move money, and the assistant never sees Plaid credentials or tokens. Without an API key, the server starts but suppresses all financial values and never substitutes sample numbers. Keys are stored as hashes, can be scoped and revoked, and responses fail closed when authoritative data is missing.

It runs locally over stdio with npx and Node.js 20 or newer. Shelter itself is a subscription at $9.99 a month or $79 a year with a 14-day trial, and the page says it does not sell financial data.

Install

Run in a terminal

claude mcp add shelter --env SHELTER_API_KEY='<SHELTER_API_KEY>' -- npx -y @shelter.money/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": [
        "-y",
        "@shelter.money/mcp"
      ],
      "env": {
        "SHELTER_API_KEY": "<SHELTER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": [
        "-y",
        "@shelter.money/mcp"
      ],
      "env": {
        "SHELTER_API_KEY": "<SHELTER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "shelter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shelter.money/mcp"
      ],
      "env": {
        "SHELTER_API_KEY": "<SHELTER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": [
        "-y",
        "@shelter.money/mcp"
      ],
      "env": {
        "SHELTER_API_KEY": "<SHELTER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shelter": {
      "command": "npx",
      "args": [
        "-y",
        "@shelter.money/mcp"
      ],
      "env": {
        "SHELTER_API_KEY": "<SHELTER_API_KEY>"
      }
    }
  }
}

Configuration

  • SHELTER_API_KEYYour scoped Shelter API key. Financial values are suppressed without one.Required
  • SHELTER_API_URLCustom API base URL (default: https://api.shelter.money/agent)

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

shelter_status
Connection and authority status, or a financial snapshot.
shelter_runway
Safe-to-spend runway and upcoming pressure.
shelter_forecast
Cash-flow forecast.
shelter_alerts
Current financial alerts.
shelter_opportunities
Savings opportunities.
shelter_context
Scoped financial context for agent reasoning.
shelter_affordability
Purchase affordability simulation.
shelter_coach_daily
Daily coaching summary.
shelter_coach_advice
Coaching for a requested topic.
shelter_ask
Asks a financial question.

What it does

Safe-to-spend
Reports what you can spend before the next payday.
Runway
Estimates days until money runs out with a daily budget.
Cash-flow forecast
Shows a verified 14-day view of a 30-day forecast.
Affordability check
Simulates the impact of a purchase before you buy.
Alerts and savings
Lists unusual spending, bills and unused subscriptions.
Scoped keys
Read-only keys that are revocable and never expose bank credentials.

Good for

  • Ask whether a purchase is safe before payday
  • Review the next 14 days for cash-flow risk
  • Find unused subscriptions to cancel
  • Get a daily money briefing in your editor
  • Pick the most urgent financial alert

Pricing

Paid, from $9.99 a month

Shelter subscription $9.99/mo or $79/yr, 14-day trial; MCP package is free

Prices change. Check shelter.money before you buy.

Shelter FAQ

Can it move money?

No. It is read-only and cannot transfer, withdraw or pay bills.

Do I need Plaid credentials?

No. You connect accounts inside Shelter; the agent gets Shelter-generated answers only.

What happens without a key?

The server starts but suppresses all financial values, with no sample data.

What does Shelter cost?

$9.99 a month or $79 a year, with a 14-day trial.

Is Shelter free?

No. Shelter is a paid product. Paid plans start at $9.99 a month.

How do I add Shelter to Claude Code?

Run this command in your terminal: claude mcp add shelter --env SHELTER_API_KEY='<SHELTER_API_KEY>' -- npx -y @shelter.money/mcp

What are the best alternatives to Shelter?

The closest alternatives to Shelter are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Shelter

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government