# Beyond Payday MCP MCP Server > **Beyond Payday MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Beyond Payday MCP. > > MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows, > token refresh, and production-grade auto-scaling — so your AI agents can connect to > third-party services and run freely without you managing any MCP server yourself. > > Server page: https://mewcp.com/mcp/beyondpayday-mcp > MewCP docs: https://docs.mewcp.com > Full catalog: https://mewcp.com/llms.txt --- ## About Beyond Payday helps AI agents analyze household finances using real financial records, including monthly cash flow, net worth, income, bills, assets, debts, savings goals, and retirement projections. Create and update financial records, track goal progress, and compare net-worth history. --- ## Details - Server ID: `beyondpayday-mcp` - Version: 1.0.0 - Tools: 53 - Authentication: OAuth, managed by MewCP - Transport: http --- ## Access The gateway URL below serves your **entire MewCP toolset**, not this server on its own. Pasting a config snippet is not enough — Beyond Payday MCP has to be in the toolset first. In order: 1. Add Beyond Payday MCP to your toolset at https://mewcp.com/mcp/beyondpayday-mcp 2. Connect your Beyond Payday MCP account (OAuth); MewCP stores the credential and attaches it to each call 3. Copy your MewCP API key from the dashboard (Developer) 4. Configure your client with the snippet for it below Once connected, an agent does **not** see this server's tools as top-level tools. It sees four meta-tools and reaches everything through them: - `search(query)` — find tools by keyword across the toolset - `get_schema(tools)` — full description and arguments for the tools you picked - `list_accounts(provider)` — only when one app has several connected accounts - `call_tool(server_maskedId, tool_name, args)` — execute So the list below is what `search` can return for this server, not a set of callable tool names on their own. --- ## Tools (53) Descriptions are truncated to 160 characters; call `get_schema` for the full text and the argument schema. Where a tool is annotated, its type is shown — treat `destructive` as irreversible. - `beyondpayday_get_overview` _(read)_ — Returns the current financial summary for the signed-in Beyond Payday account: net worth, total assets, total liabilities, and monthly gross income, take-home… - `beyondpayday_get_cash_flow` _(read)_ — Returns the Beyond Payday account's monthly cash flow — take-home income, essential bills, discretionary bills, and what is left over — plus the bills falling… - `beyondpayday_list_bills` _(read)_ — Lists recurring bills tracked in the Beyond Payday account, most recently created first, with the amount, how often it is due, its category, and whether it is… - `beyondpayday_list_income` _(read)_ — Lists income sources tracked in the Beyond Payday account, each with the full per-source breakdown Beyond Payday computes: annual and monthly gross and… - `beyondpayday_list_assets` _(read)_ — Lists assets tracked in the Beyond Payday account — accounts, property, investments and similar — with their current value, category, institution and owners.… - `beyondpayday_list_debts` _(read)_ — Lists debts and liabilities tracked in the Beyond Payday account with their outstanding balance, interest rate, maturity and owners. Each debt reports the… - `beyondpayday_list_goals` _(read)_ — Lists the savings and debt-payoff goals tracked in the Beyond Payday account. Fields per goal: `target_amount`, the figure the account holder is aiming at;… - `beyondpayday_list_businesses` _(read)_ — Lists the businesses tracked in the Beyond Payday account with their entity type, industry, estimated tax rate and valuation settings. A business's own income,… - `beyondpayday_list_business_expenses` _(read)_ — Lists the expenses of one business — the bills that belong to it — most costly first by annual cost to the business. Only ENABLED bills are included. Each… - `beyondpayday_get_business_summary` _(read)_ — Returns one business's financial picture: annual revenue, annual expenses, annual and monthly profit, the current value of the assets and debts on its own… - `beyondpayday_list_scenarios` _(read)_ — Lists the saved what-if scenarios in the Beyond Payday account — named sets of income and bill changes the account holder modelled — with the number of… - `beyondpayday_get_scenario` _(read)_ — Returns one saved what-if scenario as the What-if page shows it: each stacked life change (change_id, paused) with its rows — the user's related items, each… - `beyondpayday_get_net_worth_history` _(read)_ — Returns the saved dashboard snapshots for the Beyond Payday account, newest first — each one a dated record of net worth, total assets, total liabilities and… - `beyondpayday_get_shtf_plan` _(read)_ — Returns the household's saved SHTF (hard-times) plan: the actions it would take if income stopped — selling or withdrawing from assets, cutting or replacing… - `beyondpayday_list_savings_matches` _(read)_ — Lists the bills Beyond Payday's Save money page offers tips for, each with the tip set (`playbook`) matched to it: its label, a one-line summary and the tip… - `beyondpayday_get_profile` _(read)_ — Returns who this connection is acting as: the signed-in person's display name, their role in the family (owner, spouse or child), the family name, their… - `beyondpayday_list_holdings` _(read)_ — Lists the investments inside one account (symbol, name, kind, shares, price, value, cost basis) with the app's own summary: the total, the split by kind as… - `beyondpayday_list_equity_grants` _(read)_ — Lists the stock option, RSU, PSU and ESPP grants behind one stock compensation asset, each with its vesting schedule and figures as of today, plus `summary`:… - `beyondpayday_get_tax_profile` _(read)_ — Returns the household's saved tax facts (filing status, state and state tax rate, children and other dependents as counts, standard or itemized deduction,… - `beyondpayday_get_coverage_check` _(read)_ — Compares the household's saved insurance policies (life, disability, home, condo, renters, auto, umbrella, flood and long-term care) with common rules of… - `beyondpayday_compare_ss_claiming` _(read)_ — Shows what one person's own Social Security retirement benefit would be if claimed at each age from 62 to 70, the total received through chosen later ages, and… - `beyondpayday_create_bill` _(write)_ — Records a new recurring bill in the Beyond Payday account so it counts toward the budget. Pass business_allocations to mark it as a business expense split… - `beyondpayday_update_bill` _(write)_ — Changes fields on an existing Beyond Payday bill record. Only the fields provided are changed; everything else is left as it is.… - `beyondpayday_delete_bill` _(destructive)_ — Permanently deletes a bill record from the Beyond Payday account, along with its links to assets and businesses. This cannot be undone, and it does not cancel… - `beyondpayday_create_income` _(write)_ — Records a new income source in the Beyond Payday account so it counts toward budget and take-home calculations. Supplemental pay such as bonuses, tips, per… - `beyondpayday_update_income` _(write)_ — Changes fields on an existing Beyond Payday income record. Only the fields provided are changed. Supplemental pay is not editable through this tool; the user… - `beyondpayday_delete_income` _(destructive)_ — Permanently deletes an income record from the Beyond Payday account, along with its payroll deductions. This cannot be undone. To keep the income source but… - `beyondpayday_create_income_deduction` _(write)_ — Adds one deduction to a paycheck. A paycheck deduction is money taken out of one paycheck before it reaches the bank: retirement (401k, 403b, 457, TSP, SIMPLE… - `beyondpayday_update_income_deduction` _(write)_ — Changes fields on one paycheck deduction (ids are in each source's deductions in beyondpayday_list_income). Only the fields provided are changed. A paycheck… - `beyondpayday_delete_income_deduction` _(destructive)_ — Permanently deletes one paycheck deduction; take-home goes up by what it took. The paycheck itself and any linked account are kept. Get the id from… - `beyondpayday_create_asset` _(write)_ — Records a new asset — an account, property, vehicle or investment — in the Beyond Payday account so it counts toward net worth. This creates a record only; it… - `beyondpayday_update_asset` _(write)_ — Changes fields on an existing Beyond Payday asset record, such as its current value. Only the fields provided are changed. Changing the category of an… - `beyondpayday_delete_asset` _(destructive)_ — Permanently deletes an asset record from the Beyond Payday account. This cannot be undone, and it does not close any real account. To keep the asset but leave… - `beyondpayday_create_holding` _(write)_ — Adds one investment (for example a fund or stock) to an investment account. Holdings are informational: they never change the account's value or net worth. The… - `beyondpayday_update_holding` _(write)_ — Changes fields on one holding. Only the fields provided are changed. Holdings are informational: they never change the account's value or net worth. The… - `beyondpayday_delete_holding` _(destructive)_ — Permanently deletes one holding record. This cannot be undone and does not sell anything. It does not change the account's value. Get the id from… - `beyondpayday_create_equity_grant` _(write)_ — Adds one stock option, RSU, PSU or ESPP grant to a stock compensation asset. Grants are informational: they never change the asset's value or net worth. Beyond… - `beyondpayday_update_equity_grant` _(write)_ — Changes fields on one stock grant. Only the fields provided are changed. Grants are informational: they never change the asset's value or net worth. Beyond… - `beyondpayday_delete_equity_grant` _(destructive)_ — Permanently deletes one stock grant record. This cannot be undone and exercises or sells nothing. It does not change the asset's value. Get the id from… - `beyondpayday_update_tax_profile` _(write)_ — Changes the household's saved tax facts. Only the fields provided are changed; with no profile saved yet it creates one and then needs filing_status. Ask the… - `beyondpayday_create_debt` _(write)_ — Records a new debt or liability in the Beyond Payday account so it counts against net worth. This creates a record only; it does not borrow, pay down, or… - `beyondpayday_update_debt` _(write)_ — Changes fields on an existing Beyond Payday debt record, such as its outstanding balance. Only the fields provided are changed. This edits a record and does… - `beyondpayday_delete_debt` _(destructive)_ — Permanently deletes a debt record from the Beyond Payday account. This cannot be undone, and it does not settle or close the real obligation. To keep the debt… - `beyondpayday_create_goal` _(write)_ — Records a new savings or debt-payoff goal in the Beyond Payday account. Link it to a real account with asset_id or to a real debt with liability_id and Beyond… - `beyondpayday_update_goal` _(write)_ — Changes fields on an existing Beyond Payday goal record. Only the fields provided are changed; everything else is left as it is. `current_amount` is NOT a… - `beyondpayday_delete_goal` _(destructive)_ — Permanently deletes a goal record from the Beyond Payday account, along with the contributions logged against it. The account or debt the goal tracked is NOT… - `beyondpayday_log_goal_contribution` _(write)_ — Records a contribution against a Beyond Payday goal and returns the goal with its progress recalculated. Use this only for a goal tracked by logged… - `beyondpayday_create_business` _(write)_ — Records a new business in the Beyond Payday account, along with the business-equity asset that carries its valuation into the household's net worth and, for… - `beyondpayday_update_business` _(write)_ — Changes fields on an existing Beyond Payday business record. Only the fields provided are changed; everything else is left as it is. Changing the name or the… - `beyondpayday_update_shtf_plan` _(destructive)_ — Changes the household's SHTF (hard-times) plan the way the SHTF page does: starting numbers, each level's income/recovery/price assumptions, checking or… - `beyondpayday_create_scenario` _(write)_ — Creates a what-if scenario on the What-if planner page, optionally starting from a life change (new_job (New job), raise (Get a raise), part_time (Go… - `beyondpayday_update_scenario` _(destructive)_ — Changes a saved what-if scenario the way the What-if page does: rename it; stack a life change and fill in its form; edit a change's form (each related item's… - `beyondpayday_delete_scenario` _(destructive)_ — Permanently deletes a saved what-if scenario (the household's real data is untouched). Get the id from beyondpayday_list_scenarios. Pass the scenario's… --- ## Connect Gateway URL: https://gateway.mewcp.com/personal/mcp Every request carries one header: Authorization: Bearer Replace `API_KEY` with your own key from the dashboard (Developer). ## Apps ### Claude Desktop Mac & Windows app - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "mewcp": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://gateway.mewcp.com/personal/mcp", "--header", "Authorization: Bearer API_KEY" ] } } } ``` Already have an "mcpServers" section in your config? Just add the server entry inside it. 1. Open Claude Desktop → Settings → Developer → "Edit Config" 2. Paste the snippet inside the outer { } of the config file (merge with your existing "mcpServers" section if you have one) 3. Save the file and restart Claude Desktop 4. Start a new conversation — your tool will be available ### VS Code Copilot / Cline - Command Palette → "MCP: Open User Configuration" (opens mcp.json). For one project only, use .vscode/mcp.json instead. ```json { "mcp.servers": { "mewcp": { "type": "http", "url": "https://gateway.mewcp.com/personal/mcp", "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Already have a "servers" section in your mcp.json? Just add the server entry inside it. 1. Open VS Code → Command Palette (Cmd+Shift+P / Ctrl+Shift+P) 2. Run "MCP: Open User Configuration" to open your mcp.json 3. Paste the snippet and save 4. Start the server when prompted (or from the MCP servers view) and use it in Copilot Chat ### Cursor AI-first editor - macOS: `~/.cursor/mcp.json` - Windows: `%USERPROFILE%\.cursor\mcp.json` ```json { "mcpServers": { "mewcp": { "url": "https://gateway.mewcp.com/personal/mcp", "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Already have an "mcpServers" section in your mcp.json? Just add the server entry inside it. 1. Open Cursor → Settings → Cursor Settings → MCP 2. Click "Add new global MCP server" 3. Paste the snippet and save 4. Restart Cursor ### Codex OpenAI's CLI agent - Add the snippet to your Codex MCP config or your standard MCP config file for the CLI tool you use. ```json { "mcpServers": { "mewcp": { "type": "http", "url": "https://gateway.mewcp.com/personal/mcp", "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Codex generally reads a standard MCP server block, so you can add this alongside your other configured servers. 1. Open your Codex MCP config or project-level config file 2. Paste the MewCP server block inside the config JSON/TOML structure your tool expects 3. Save the file and restart Codex 4. Verify the tool is available inside a fresh session ### Claude Code Anthropic's CLI agent - ~/.claude.json (user scope) or .mcp.json in your project root — create it if it doesn't exist. Or skip the file and use the CLI command below. ```json { "mcpServers": { "mewcp": { "type": "http", "url": "https://gateway.mewcp.com/personal/mcp", "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Already have an "mcpServers" section in your config? Just add the server entry inside it. 1. Open ~/.claude.json (or .mcp.json in your project root) in a text editor 2. Paste the snippet inside the outer { } (merge with your existing "mcpServers" section if you have one) 3. Save the file and start (or restart) Claude Code 4. Or skip the file entirely and run the CLI command below instead ### OpenCode Open-source terminal agent - ~/.config/opencode/opencode.json (global) or opencode.json in your project root — create it if it doesn't exist. ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "mewcp": { "type": "remote", "url": "https://gateway.mewcp.com/personal/mcp", "enabled": true, "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Already have an "mcp" section in your opencode.json? Just add the server entry inside it. 1. Open ~/.config/opencode/opencode.json (or opencode.json in your project root) in a text editor 2. Paste the snippet inside the outer { } (merge with your existing "mcp" section if you have one) 3. Save the file and start (or restart) OpenCode ### OpenClaw Self-hosted agent gateway - ~/.openclaw/openclaw.json — create it if it doesn't exist. ```json { "mcp": { "servers": { "mewcp": { "transport": "streamable-http", "url": "https://gateway.mewcp.com/personal/mcp", "enabled": true, "headers": { "Authorization": "Bearer API_KEY" } } } } } ``` Already have an "mcp" section in your openclaw.json? Just add the server entry inside "servers". 1. Open ~/.openclaw/openclaw.json in a text editor 2. Paste the snippet inside the outer { } (merge with your existing "mcp" section if you have one) 3. Save the file and restart OpenClaw ### Antigravity Google's agentic IDE - ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (workspace-local) — create it if it doesn't exist. ```json { "mcpServers": { "mewcp": { "serverUrl": "https://gateway.mewcp.com/personal/mcp", "headers": { "Authorization": "Bearer API_KEY" } } } } ``` Already have an "mcpServers" section in your config? Just add the server entry inside it. Remote servers must use the "serverUrl" field — the legacy "url"/"httpUrl" fields aren't supported. 1. In the editor's agent side panel, click "…" → "MCP Servers" → "Manage MCP Servers" → "View raw config" (Antigravity CLI: type /mcp instead to open the Interactive MCP Manager) 2. Paste the snippet inside the outer { } (merge with your existing "mcpServers" section if you have one) 3. Save the file — the server connects automatically ### Hermes Nous Research's CLI agent - config.yaml in your Hermes config directory (~/.hermes) — add this under a top-level "mcp_servers:" key. ```yaml mcp_servers: mewcp: url: "https://gateway.mewcp.com/personal/mcp" headers: Authorization: "Bearer API_KEY" ``` Already have an "mcp_servers" section in your config.yaml? Just add the server entry inside it. 1. Open config.yaml in your Hermes config directory 2. Paste the snippet under the top-level "mcp_servers:" key (merge with existing entries if you have any) 3. Save the file, then run /reload-mcp in Hermes (or start a fresh session) 4. Ask Hermes "Tell me which MCP-backed tools are available right now" to confirm it connected ### DeepSeek Harness DeepSeek's agent harness - cordis.yml in your DSH project — or the patch file you mount plugins from. ```yaml - id: mcp-mewcp name: '@deepseek-ai/dsh-mcp-client' config: serverName: mewcp transport: streamable-http url: https://gateway.mewcp.com/personal/mcp headers: Authorization: "Bearer API_KEY" ``` One plugin instance = one MCP server. Add this entry to your plugin list; don't nest it inside another entry. 1. Open cordis.yml (or your patch file) in your DSH project 2. Paste the entry into your plugin list, keeping the leading dash and indentation 3. Restart DSH (or let HMR reload) — tools register as mcp__mewcp__ 4. Verify with: dsh web --dump-config | grep -A3 mcp ## SDKs ### Python fastmcp client ```python import asyncio from fastmcp import Client from fastmcp.client.transports import StreamableHttpTransport SERVER_URL = "https://gateway.mewcp.com/personal/mcp" API_KEY = "API_KEY" transport = StreamableHttpTransport( url=SERVER_URL, headers={ "Authorization": f"Bearer {API_KEY}", } ) async def main(): client = Client(transport) async with client: tools = await client.list_tools() print(tools) asyncio.run(main()) ``` 1. Install fastmcp: pip install fastmcp 2. Copy the snippet into your project 3. Replace API_KEY with your key from the dashboard 4. Run your script ### TypeScript MCP SDK ```typescript import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"; const SERVER_URL = "https://gateway.mewcp.com/personal/mcp"; const API_KEY = "API_KEY"; const transport = new StreamableHTTPClientTransport(new URL(SERVER_URL), { requestInit: { headers: { Authorization: `Bearer ${API_KEY}`, }, }, }); const client = new Client({ name: "mewcp-client", version: "1.0.0" }); await client.connect(transport); const tools = await client.listTools(); console.log(tools.tools.map((t) => t.name)); ``` 1. Install: npm install @modelcontextprotocol/sdk 2. Copy the snippet into your project 3. Replace API_KEY with your key from the dashboard 4. Run with Node 18+ as an ES module (e.g. npx tsx script.ts)