Skip to content

ExpenseBot MCP server

io.github.TotesMagotes/mcp-server-authTotesMagotesstreamable-httpv0.6.28Scanned

Receipt ingestion, Gmail capture, expense analysis, and reviewed reports for AI-agent workflows.

65 tools: 9 can delete or cancel things, 2 do something that can't be undone, 20 change things and 34 only read.

Tools: 9 delete, 2 irreversible, 20 write, 34 read.
  • Reads private data · 4
  • Reads text others write · 32
  • Can send data out · 1
  • 1 finding

Tools listed without sign-in. Remote posture

With Anlyon

9 tools here can delete or cancel things and 2 do something that can't be undone. Govern them.

  • Anlyon lists the tools and adopts none.
  • Each tool you adopt gets approvals and receipts.
  • Your agent never holds the key.
Govern this server →

A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.

What the ExpenseBot MCP server can do

The ExpenseBot MCP server is published by the GitHub account TotesMagotes. It has 65 tools. It can delete or cancel things (9 tools: complete_setup, create_report, share_report, fix_compliance and 5 more), do things that cannot be undone, such as sending, paying or publishing (add_income and send_report_to_accounting) and create or change data (20 tools: get_deep_analytics, request_accounting_integration, check_compliance, check_tax_deductibility and 16 more). 34 tools only read.

4 tools read private data (get_recent_activity, trace_document, get_client_invoice and 1 more); 32 tools bring in text other people can write (get_setup_status, complete_setup, search_expenses and 29 more); 1 tool can send data out of your system (send_report_to_accounting). On its own it has all three parts of a prompt-injection exfiltration path: private data, text others write, and a way out.

The fixed checks matched 1 finding (annotation-conflict). Each one comes with the text it matched.

Its remote endpoint lists its tools without sign-in, and its tools changed 2 times since Anlyon Radar first saw them.

Last scanned Nov 11, 2026, version 0.6.28.

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

65 tools

Deletes or cancels 9Claude Code: deny
  • complete_setupPreview explicit setup answers, never infer.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "preview": a word for reading.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Preview explicit setup answers, never infer. Show changes/access/recipients; approval then proposalId+confirm:true only. Owner/revision-bound; rejects changed state. Lost reply: proposalId+status:true; never resend blindly. Re-read get_setup_status. Personal Rules need validation/activation; invites are not client access. OAuth/bank/reviews use screens. No financial writes/client acting.

    Annotations the server declares

    • title: Preview and complete setup
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • correct_expensesPreview and correct category, business purpose or user-supplied attendees on one or more exact expenses; first search_expenses for full expenseIds.Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "preview": a word for reading.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Preview and correct category, business purpose or user-supplied attendees on one or more exact expenses; first search_expenses for full expenseIds. Automatic preview with confirm omitted/false: show exact count and before/after changes, ask approval once, then repeat identical operationId/selection/change with confirm:true; early confirm returns preview. Never infer attendee names/business context. attendeeMode add preserves existing attendees; replace changes only that Notes segment. Preserve card, description, inbox and other structured Notes segments; skip Formula Notes/overflow. Terminal result gives applied/conflicted/failed counts, status and Undo. Does not omit duplicates, change amounts/dates or do broad Calendar matching; omit/restore via omit_expenses; one row's merchant or tag: update_expense. Mixed (e.g. category plus attendees), unsupported or over-100-row cleanup: https://www.expensebot.ai/review-expenses?source=mcp.

    Annotations the server declares

    • title: Correct selected expenses
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • create_client_invoiceCreate the exact invoice previously returned by prepare_client_invoice.Reads text others writeNo findings

    Why it is in this group

    • The name "create_client_invoice" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create the exact invoice previously returned by prepare_client_invoice. This is a confirmed write: it revalidates the report snapshot and client identity, creates a private editable Google Doc plus private PDF and DOCX copies, records the issued invoice, and supersedes an older active invoice for the same report. It does not send email or create an Income row. If tax is positive, confirmTax must be true.

    Annotations the server declares

    • title: Create client invoice
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • create_reportCreate a report for clear date/client/project/trip/category/merchant criteria.Reads text others writeNo findings

    Why it is in this group

    • The name "create_report" says "create": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a report for clear date/client/project/trip/category/merchant criteria. Tags group clients/projects/codes/trips; list_tags if unclear. excludePersonal=true excludes both Personal tag and Personal expense category, as in Report Wizard. Returns summary, exact report/Bill Client links, filters and a prefilled Report Wizard for visual criteria. Optional shareWith recipients (user-named only; emailed). No server preview: creates on call. Group-scoped reports exclude rows on other ordinary reports. No unreported matches: explain existing Reports; never duplicate. Use role-aware accountingHandoffUrls only for the requested destination; opening is not export proof. Complete directly; no check_compliance/get_report_details/tax/deductibility analysis before or after unless explicitly requested.

    Annotations the server declares

    • title: Create expense report
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • fix_complianceFix recorded expenses only after an explicit request to fix check_compliance findings; follow correct_expenses.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Fix recorded expenses only after an explicit request to fix check_compliance findings; follow correct_expenses. Use exact expenseIds from search_expenses; never select all report rows or infer purpose/category/attendees. First call always gives a no-write before/after preview, even with early confirm:true; show changes and ask approval, then repeat identical operationId/selection/change with confirm:true. Terminal result gives applied/conflicted/failed counts, status and Undo. Group via group_expenses. Unsupported or over 100 rows: https://www.expensebot.ai/review-expenses?source=mcp.

    Annotations the server declares

    • title: Fix compliance issues
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • group_expensesGroup exact expenses for a user-named client/project/trip/job, with an optional report.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Group exact expenses for a user-named client/project/trip/job, with an optional report. Reuse existing groups; propose new only if needed. Full expenseIds from search_expenses. Preserve assignments unless explicitly replacing (replaceExistingTags:true). First call previews even with early confirm:true: show rows, count, totals, group, exclusions/conflicts; ask approval once, then repeat identical operationId/selection with confirm:true. Group-and-report: createReport:true on confirmation; never a separate broader create_report query. excludePersonal:true removes Personal-tagged and Personal-category rows before preview, preserving markers. Skip rows on other ordinary reports; no matches: no duplicate, link to Reports. Exact report/Bill Client links. Say group, not tag. Preview totals are provisional; use terminal count/total/currency. Bill Client opens a reviewed flow, not a created/sent/confirmed invoice. Sharing requires share_report recipient confirmation. No unsolicited tax/substantiation advice or check_compliance/get_report_details/tax calls unless explicitly requested.

    Annotations the server declares

    • title: Group selected expenses
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • mark_client_invoice_paidMark an issued client invoice as paid after explicit confirmation.No findings

    Why it is in this group

    • The name "mark_client_invoice_paid" says "mark": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Mark an issued client invoice as paid after explicit confirmation. Requires a strict calendar-valid paidDate in YYYY-MM-DD format. This updates the accounts-receivable invoice record only; it never creates or moves an Income row. Record the actual payment separately or link an existing Income row.

    Annotations the server declares

    • title: Mark client invoice paid
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: false
  • share_reportShare one existing expense report with user-named recipients.Reads text others writeNo findings

    Why it is in this group

    • The input addresses people (input.recipients): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Share one existing expense report with user-named recipients. No server preview: shares and emails on call. Default to reviewer: they can open and edit that report's Google Sheet, inspect receipts, comment, approve, or request changes, but cannot act for the owner or use accounting integrations. Use accountant only when the user explicitly asks for ongoing accounting access; it creates the established accountant relationship and broader report-management workflow.

    Annotations the server declares

    • title: Share expense report
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
  • update_expenseUpdate a single existing expense row's category, tag, merchant or business purpose (e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "update_expense" says "update": a word for a change.
    • The server marks it destructive (destructiveHint: true).

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Update a single existing expense row's category, tag, merchant or business purpose (e.g. 'recategorize expense X to Meals', 'tag it Client – Acme'). Identify it only by the exact expenseId from search_expenses (the full Receipt ID from Column Q); never a date, displayed number or sheet row number. Two-phase: calls with confirm omitted/false return a current→proposed preview and change nothing; after user confirmation, confirm:true applies it. If the expense is not found, search once for a current exact expenseId; never retry the same stale ID. If a business-purpose update exceeds the Notes capacity, stop and send the user to https://www.expensebot.ai/review-expenses?source=mcp. fields.paidWith edits only the optional Paid with bookkeeping label (no status/settlement change; blank clears it); reuse expectedPaidWith from the preview on confirm. Amounts, dates and raw notes require Review Expenses. Does not create or delete rows. Same change on several rows or attendees: correct_expenses; leave rows out: omit_expenses.

    Annotations the server declares

    • title: Edit an expense's category/tag/merchant
    • readOnlyHint: false
    • destructiveHint: true
    • openWorldHint: true
Can't be undone 2Claude Code: ask
  • add_incomeLog exactly one confirmed income payment (cash/check/Stripe/etc.) to Income, e.g.Reads text others writeNo findings

    Why it is in this group

    • The name "add_income" says "add": a word for a change.
    • The input carries an amount (input.amount) and a currency, so it moves money.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Log exactly one confirmed income payment (cash/check/Stripe/etc.) to Income, e.g. income absent from Gmail/Plaid; no server preview, it writes on call. Never loop over statements/exports/tables/lists. Multiple payments: add_income_from_csv for CSV/TSV/text or add_income_from_file for image/PDF; both duplicate-check, preview and require confirmation. Call list_income_categories first; use fixed tax categories. Omitted category defaults to Service income; unknown is rejected.

    Annotations the server declares

    • title: Log income entry
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • send_report_to_accountingPreview then post an owner's report to accounting.Reads text others writeCan send data outNo findings

    Why it is in this group

    • The name "send_report_to_accounting" says "send": a word for sending, and what is sent cannot be taken back.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • outboundThe name "send_report_to_accounting" says "send": it sends or publishes something to other people.
    Description, as the server wrote it
    Preview then post an owner's report to accounting. Step 1: provider/reportId, optional mode/mappings, NO confirm. Reads live report/destination, enforces Omit/Personal/split/date/currency rules and Zoho bank-feed checks; returns complete frozen proposal + proposalId, posts nothing. Show complete proposal and ask approval. Step 2: ONLY provider/proposalId/confirm:true, never mappings. Revalidates live state and rejects changed reports/mappings; account-bound proposal only. No client acting. Agent posting: Zoho Books (zoho_books) only. QuickBooks Online/Xero/Wave/FreeAgent cannot yet freeze/revalidate shareReport plans; use their web flows.

    Annotations the server declares

    • title: Review and send report to accounting
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
Changes things 20Claude Code: ask
  • add_cash_expenseAdd one receiptless expense or client-provided expense advance to the expense sheet after the user confirms; no server preview, it writes on call.Reads text others writeNo findings

    Why it is in this group

    • The name "add_cash_expense" says "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Add one receiptless expense or client-provided expense advance to the expense sheet after the user confirms; no server preview, it writes on call. Ordinary expenses: list_categories first; use a configured Expense Account. Advances: isClientAdvance=true + clientName reuses/creates the canonical client group, applies Cash advance received and writes a negative expense. Only client money provided before spending; never for vendor refunds, reimbursements, earned fees, retainers or generic deposits. Multiple/incomplete entries, refunds, tax/tip/per diem: Manual expense link from get_spreadsheet_url.

    Annotations the server declares

    • title: Log cash expense
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • add_income_from_csvUse this to import the user's CSV/TSV/text income export (max 500 KB).Reads text others writeNo findings

    Why it is in this group

    • The name "add_income_from_csv" says "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Use this to import the user's CSV/TSV/text income export (max 500 KB). Step 1 stages a duplicate-checked previewId without writing Income rows. Show it and obtain approval. Step 2 uses confirm:true and that previewId to write the approved rows/edits; duplicates require explicit keep approval. Unknown or expired previews never write (15-minute expiry). Return spreadsheetUrl and reviewIncomeUrl after success. Accepts user-provided attachments or inline text, not arbitrary web URLs.

    Annotations the server declares

    • title: Import income from a CSV/TSV/text export
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • add_income_from_fileImport income from attached JPEG/PNG/WebP/HEIC/HEIF screenshots/images or PDF (payment/wallet/payout/bank statement; max 10 MB).Reads text others writeNo findings

    Why it is in this group

    • The name "add_income_from_file" says "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Import income from attached JPEG/PNG/WebP/HEIC/HEIF screenshots/images or PDF (payment/wallet/payout/bank statement; max 10 MB). Step 1: file WITHOUT confirm uses Add Income's parser and Income-tab duplicate check. Returns previewId, exact count, currency totals, rows, duplicate flags/rejections; parses only, saves nothing. Attachment is not write consent. Show rows/duplicates. Step 2: confirm:true + previewId writes only user-approved selectedIndexes/keepBothIndexes/rowEdits/tag/bulkNote. Skip flagged duplicates unless explicitly approved in keepBothIndexes. Unknown/expired previews (15 minutes) never write. Success: show spreadsheetUrl + reviewIncomeUrl. Mixed income/expense or many edits: Add Income link from get_spreadsheet_url.

    Annotations the server declares

    • title: Import income from an image or PDF
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • add_mileage_entryLog one user-confirmed business trip; writes on call, no server preview.Reads text others writeNo findings

    Why it is in this group

    • The name "add_mileage_entry" says "add": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Log one user-confirmed business trip; writes on call, no server preview. Saved mode selects rate-based expense or distance-only trip; trackingMode overrides. For routes, vehicle setup/readings, imports or review, open Mileage and travel via get_spreadsheet_url.

    Annotations the server declares

    • title: Log mileage trip
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • check_complianceUse only when the user explicitly asks to check an existing report for compliance issues such as missing business purpose or policy violations.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Use only when the user explicitly asks to check an existing report for compliance issues such as missing business purpose or policy violations. Creating a report, excluding Personal expenses, sharing a report, or billing a client is not a compliance request; never call this tool automatically as a preflight or follow-up for those workflows.

    Annotations the server declares

    • title: Check report compliance
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • check_featureCheck whether ExpenseBot supports a specific feature ('does ExpenseBot support X', 'can it integrate with Y').No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Check whether ExpenseBot supports a specific feature ('does ExpenseBot support X', 'can it integrate with Y'). Searches the public knowledge base and returns a confidence-scored answer + related questions. Works with or without authentication.

    Annotations the server declares

    • title: Check ExpenseBot feature
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • check_tax_deductibilityUse this when the user asks for general deduction guidance for an expense type, such as business meals or home-office expenses.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Use this when the user asks for general deduction guidance for an expense type, such as business meals or home-office expenses. Looks up reference rules using the account's tax-country/home settings and current year. A verified rule may return a percentage and reference; unverified rules return unknown/reviewRequired without a percentage. Read-only: it does not classify saved expenses, prepare a return, or determine the user's actual tax liability. Do not use for tax refunds received as income; use get_income_summary for recorded refunds. General guidance is not a tax professional's determination.

    Annotations the server declares

    • title: Check tax deductibility
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • create_tagCreate a standalone group/tag without selecting or changing any expenses.Reads text others writeNo findings

    Why it is in this group

    • The name "create_tag" says "create": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Create a standalone group/tag without selecting or changing any expenses. The first call prepares a preview; after the user explicitly chooses to create it, send confirm:true with the returned operationId (fresh duplicate checks run). A first call with confirm:true still returns a preview. An exact canonical duplicate is a no-op; archived tags are not reactivated. Similar names are returned as choices; set allowSimilar:true only when the user explicitly chooses a distinct new group despite them. Use list_tags to inspect all groups.

    Annotations the server declares

    • title: Create a group/tag
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • get_deep_analyticsRun deeper, multi-step analytics on the user's expenses.1 finding

    Why it is in this group

    • The name "get_deep_analytics" says "get": a word for reading.
    • The description's first verb is "run": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "get_deep_analytics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The name "get_deep_analytics" says "get": a word for reading.

      What this check looks for
    Description, as the server wrote it
    Run deeper, multi-step analytics on the user's expenses. Use for explanatory questions like 'why did my spending increase' or 'compare Q1 vs Q2'. Takes 10-30 seconds (runs as a background job, polled automatically). Returns: { message, data: { ..., sampleMeta? } } where sampleMeta.isTruncated indicates whether the agent saw the full dataset.

    Annotations the server declares

    • title: Run deep analytics
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • omit_expensesOmit exact recorded expenses from reports, insights and exports, or restore them (leave out, exclude, don't count).Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Omit exact recorded expenses from reports, insights and exports, or restore them (leave out, exclude, don't count). First search_expenses for full expenseId values. A grounded preview is automatic with confirm omitted/false: show exact rows (date, merchant, amount), count and skips, ask once, then repeat identical operationId, action and expenseIds with confirm:true. Premature confirmation returns preview. Omit is reversible and keeps the spreadsheet row; never deletes. Rows on a submitted report are skipped and stay on it. Act only on rows the user chose; never decide rows are duplicates or personal. Recategorize: correct_expenses. Result gives applied/skipped/conflicted/failed counts and Undo. Over 100 rows: https://www.expensebot.ai/review-expenses?source=mcp.

    Annotations the server declares

    • title: Omit or restore selected expenses
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • parse_expenseParse a natural language expense description into structured fields.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Parse a natural language expense description into structured fields. Does NOT add the expense: returns fields to show the user; once they approve, save with add_cash_expense. Example: "Lunch at Chipotle $15.50 today" → {merchant: "Chipotle", total: 15.50, ...}

    Annotations the server declares

    • title: Parse expense text
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • prepare_client_invoicePrepare a client invoice from a saved ExpenseBot report without creating it.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Prepare a client invoice from a saved ExpenseBot report without creating it. Reads canonical report rows, allocates a unique invoice number, verifies the client ledger identity and advance, and returns exact totals plus a short-lived preparationId. Call this first, show the preview to the user, then call create_client_invoice after explicit confirmation. It reserves the invoice number and preview for 30 minutes but creates no invoice, document, Income row, email, or payment.

    Annotations the server declares

    • title: Prepare client invoice
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: false
  • process_gmail_receiptsProcess specific Gmail emails as receipts when the user supplies Gmail message IDs; to find receipts use scan_gmail.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Process specific Gmail emails as receipts when the user supplies Gmail message IDs; to find receipts use scan_gmail. No server preview: on call each email is converted to PDF, extracted by AI and added to the user's expense spreadsheet. Max 25 emails per request. Requires Gmail connected in ExpenseBot.

    Annotations the server declares

    • title: Process specific Gmail receipts
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • request_accounting_integrationRequest an exact accounting package only after checking reviewed direct/import-file destinations and finding no match.Reads text others writeNo findings

    Why it is in this group

    • The name "request_accounting_integration" says "request": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Request an exact accounting package only after checking reviewed direct/import-file destinations and finding no match. Do not use this for a listed or Beta destination or general compatibility. A confirmation-gated write: after user approval, creates one deduplicated request bound to the authenticated account and emails ExpenseBot's internal team. Does not create an integration or immediate availability. For accepted/already-recorded requests, say ExpenseBot will email an update within one week.

    Annotations the server declares

    • title: Request an accounting integration
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • scan_gmailTrigger a background Gmail scan to discover and process receipt emails from the last ~60 days (default).Reads text others writeNo findings

    Why it is in this group

    • The description's first verb is "trigger": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Trigger a background Gmail scan to discover and process receipt emails from the last ~60 days (default). No server preview: starts on call and runs in the background; the user gets an email summary when done. Like clicking "Find Receipts in Gmail" in the UI. For whole PAST YEARS (e.g. 2023, or 2020-2022) use scan_gmail_years instead; to check a scan's progress use get_scan_status. With provider:outlook, returns an access-gated screen handoff only; no scan starts.

    Annotations the server declares

    • title: Scan Gmail for receipts
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • scan_gmail_yearsprovider:outlook returns a handoff; never starts.Reads text others writeNo findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    provider:outlook returns a handoff; never starts. Scan completed Gmail periods for receipts. In eligible split-tax-year accounts, a number is the period's ending year (2025 = 2024–25 tax year); otherwise it is a calendar year. Use returned tax-period labels and inclusive ISO bounds. Long-running: the first eligible period starts immediately; the rest queue one at a time (each full period typically takes hours; the app may close). Preview without confirmStart (no scan starts), ask the user to confirm, then start with confirmStart:true. For recent receipts (~60 days), use scan_gmail. The in-progress period cannot be year-scanned; use get_scan_status for progress.

    Annotations the server declares

    • title: Scan past years of Gmail
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • submit_receiptProcess receipt images/PDFs, including 'log this', 'save this receipt', 'expense this', 'add this to my expenses' or a shared receipt/invoice photo.Reads text others writeNo findings

    Why it is in this group

    • The name "submit_receipt" says "submit": a word for a change.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Process receipt images/PDFs, including 'log this', 'save this receipt', 'expense this', 'add this to my expenses' or a shared receipt/invoice photo. Starts on call (no server preview); AI extracts vendor, amount, date, tax and category (usually 1–3 minutes; longer for PDFs/batches); poll get_last_receipt_result with the returned submissionId. Mixed images/PDFs work. Required for PDFs; use this flow for large files/batches: call filesToUpload for EVERY file; PUT each ONE AT A TIME to signed URLs, report file/count progress, then call ONCE with all uploadRefs as one batch, never once per file. photo accepts one ChatGPT image/PDF; photoBase64 only for one small image without file references. note maps to Notes L, tag to Tag K; batch defaults apply to all files and uploadRefs items may override.

    Annotations the server declares

    • title: Submit receipt photo or PDF
    • readOnlyHint: false
    • destructiveHint: false
    • openWorldHint: true
  • whatif_affordCan I afford $X/month?No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Can I afford $X/month? Recomputes the user's Safe Monthly Draw (how much they can safely pay themselves) with an added recurring monthly cost, and returns a yes/tight/no verdict plus the before/after numbers. Use for questions like 'can I afford a $500/mo hire' or 'what if I add a $200/mo software subscription'. Requires at least 3 months of income history — otherwise returns insufficient_data rather than a guess.

    Annotations the server declares

    • title: What-if: can I afford this?
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • whatif_clientWhat if a client pays late or leaves?No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    What if a client pays late or leaves? mode='late30' shifts that client's OPEN invoice amounts out of the near-term expectation mode='gone' removes that client's trailing monthly income contribution and recomputes Safe Draw against the reduced baseline. Use for questions like 'what if Acme Corp pays 30 days late' or 'what happens if I lose my biggest client'. Client identity is matched against the Income tab's tag/source/description fields — best effort, not a guaranteed match.

    Annotations the server declares

    • title: What-if: client pays late or leaves
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • whatif_tax_setasideWhat should I set aside for taxes?No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    What should I set aside for taxes? Returns the monthly tax set-aside estimate already computed for Safe Monthly Draw. Flat-rate estimate (default 30%) against trailing income minus recurring + variable spend. Use for 'how much should I set aside for taxes this month'.

    Annotations the server declares

    • title: What-if: tax set-aside
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
Only reads 34Show 34 read-only tools
  • export_reportGet a short-lived direct PDF download for one exact authorized expense report, plus the exact highlighted in-app report link.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    Get a short-lived direct PDF download for one exact authorized expense report, plus the exact highlighted in-app report link. Use the in-app report for CSV, XLSX, receipt ZIP (when available), comments, invoicing, and other visually reviewed actions. Use list_reports first to find the reportId.

    Annotations the server declares

    • title: Get report export URLs
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • fetchFetch full details for a specific item returned by `search`.No findings

    Why it is in this group

    • The name "fetch" says "fetch": a word for reading.
    Description, as the server wrote it
    Fetch full details for a specific item returned by `search`. The id encodes the item type: • 'expense:<expenseId>' — the durable Column-Q Receipt ID returned by `search`, URL-encoded, e.g. 'expense:RR-123%3A%3Adrive%2Ffile%209'. Never a sheet row number: rows move when the sheet is prepended. • 'report:<reportId>' — the alphanumeric Firestore document id from `search` or `list_reports`, e.g., 'report:FQqDglExofsyyQv7aYy4' • 'kb:<entryId>' — the knowledge-base entry id from `search` Use ids exactly as returned; never alter them. Returns full text + metadata to cite. Outside Deep Research read one expense with get_expense_by_id.

    Annotations the server declares

    • title: Fetch full item details
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_accounting_integration_statusRead the owner's accounting connection/setup state, selected organization/company/business, rollout state and one connect/reconnect setupUrl.Reads text others writeNo findings

    Why it is in this group

    • The name "get_accounting_integration_status" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    • untrusted-inputThe description's first sentence says "read" and "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Read the owner's accounting connection/setup state, selected organization/company/business, rollout state and one connect/reconnect setupUrl. Pass an existing reportId to open that exact report's provider setup control; otherwise general Reports setup. Never posts data. Agent posting: Zoho Books only; QuickBooks Online, Xero, Wave and FreeAgent (beta) are connection/status only (writesAuthorized=false).

    Annotations the server declares

    • title: Check accounting integration status
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • get_accounting_push_statusRead the authoritative posting and reconciliation status for one ExpenseBot report at an accounting destination.No findings

    Why it is in this group

    • The name "get_accounting_push_status" says "get": a word for reading.
    Description, as the server wrote it
    Read the authoritative posting and reconciliation status for one ExpenseBot report at an accounting destination. Use after a timeout or uncertain response before considering any retry. Returns status, submission time, posting mode, posted receipt count, any public error, and whether reconciliation is required. Never re-post a completed report or a report marked needs_reconciliation; show that state to the owner instead. This tool is read-only and owner-account only.

    Annotations the server declares

    • title: Check accounting push status
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_client_advance_balancesRead the same per-client advance balances shown in ExpenseBot's Client advances section.No findings

    Why it is in this group

    • The name "get_client_advance_balances" says "get": a word for reading.
    Description, as the server wrote it
    Read the same per-client advance balances shown in ExpenseBot's Client advances section. Use for questions like 'how much of Acme's advance remains?', 'which client floats are still open?', or 'do I owe a client a refund?'. A negative ledger balance means money remains to refund; a positive balance means the client owes the user. Returns the existing app handoff for Refund leftover or Bill Client. Read-only: never records a refund, creates an invoice, or recomputes the ledger in model prose.

    Annotations the server declares

    • title: Check client advance balances
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_client_invoiceGet the full financial and delivery summary for one issued client invoice, including subtotal, markup, tax, advance applied, balance due, dates, status, source report, and private …Reads private dataNo findings

    Why it is in this group

    • The name "get_client_invoice" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "get" and "doc": it reads documents.
    Description, as the server wrote it
    Get the full financial and delivery summary for one issued client invoice, including subtotal, markup, tax, advance applied, balance due, dates, status, source report, and private Google Doc/PDF/DOCX links when available. Provide invoiceId or invoiceNumber — one is required; invoiceNumber is accepted only when it is unique. Read-only.

    Annotations the server declares

    • title: Get client invoice details
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_credits_refundsList card refunds, cashback/rewards, and statement credits that ExpenseBot has already recorded — either as negative expenses or matched against the original charge.No findings

    Why it is in this group

    • The name "get_credits_refunds" says "get": a word for reading.
    Description, as the server wrote it
    List card refunds, cashback/rewards, and statement credits that ExpenseBot has already recorded — either as negative expenses or matched against the original charge. Examples: 'did my refund come through', 'show my statement credits', 'was that return recorded'. Returns the most recent items (default 25, newest first); narrow with dateRange. Read-only: it never scans cards, changes review decisions, or adds rows.

    Annotations the server declares

    • title: List recorded credits and refunds
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_expense_by_idRead one existing expense from the authenticated user's ExpenseBot spreadsheet.Reads text others writeNo findings

    Why it is in this group

    • The name "get_expense_by_id" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read one existing expense from the authenticated user's ExpenseBot spreadsheet. Supply the exact expenseId returned by search_expenses (Receipt ID in Column Q), or the user's specified rowNumber. Never invent an identifier. Returns sheetName, rowNumber, headers, values, labeled fields and, when available, reviewExpenseUrl. This tool does not edit, submit, delete, share, or scan anything. Also returns Paid with context (unavailable differs from blank) and typed bookkeeping paymentStatus, never bank settlement proof.

    Annotations the server declares

    • title: Get expense by ID
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • get_expense_splitsRead a payment's category/client/property/business-personal allocation.No findings

    Why it is in this group

    • The name "get_expense_splits" says "get": a word for reading.
    Description, as the server wrote it
    Read a payment's category/client/property/business-personal allocation. Returns one parent with nested split lines; never count split lines as separate expenses. Use for 'how is this expense split' or 'business portion'. Edit splits in ExpenseBot Review workspace.

    Annotations the server declares

    • title: View expense splits
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_income_summaryUse this when the user asks about income already recorded in their ExpenseBot Income tab.No findings

    Why it is in this group

    • The name "get_income_summary" says "get": a word for reading.
    Description, as the server wrote it
    Use this when the user asks about income already recorded in their ExpenseBot Income tab. Read totals; group by source, category, month, payment method or tag; filter by dateRange/incomeTagPrefix. Query supports period comparisons (e.g. 'income YTD by source', 'income this year vs last'). Returns message and data with total and optional breakdown, comparison, sampleMeta. No scanning, imports, mutations, tax returns or liability determination.

    Annotations the server declares

    • title: Get income summary
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_last_receipt_resultRead the authoritative outcome of a receipt batch: a submit_receipt batch by its exact ID (submissionId), or the latest upload (including in-app) via withinSeconds.No findings

    Why it is in this group

    • The name "get_last_receipt_result" says "get": a word for reading.
    Description, as the server wrote it
    Read the authoritative outcome of a receipt batch: a submit_receipt batch by its exact ID (submissionId), or the latest upload (including in-app) via withinSeconds. Poll at the returned interval/time allowance (small batch at least 5 minutes; larger longer). Pending is normal: never blindly resubmit. found:false = pending/no terminal verdict; found:true = terminal. Returns added/duplicate/skipped/held_for_review/errored per-file outcomes, exact counts and up to 10 summaries. Held files (missing details or a possible duplicate) were not added; relay only their message's next step (use the returned Review files link), do not invent a missing card or direct held uploads to Gmail Action Needed. Show spreadsheetUrl/reviewExpensesUrl for rows actually added, not for held files. Unknown outcomes stay unknown. Gmail scans use get_scan_status. Read-only.

    Annotations the server declares

    • title: Check a submitted receipt outcome
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_mileage_summaryRecorded mileage expenses and Trip Log distances, with month/client/purpose/category breakdowns and date ranges.No findings

    Why it is in this group

    • The name "get_mileage_summary" says "get": a word for reading.
    Description, as the server wrote it
    Recorded mileage expenses and Trip Log distances, with month/client/purpose/category breakdowns and date ranges. Expense amounts are not tax-deductibility determinations.

    Annotations the server declares

    • title: Get mileage summary
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_monthly_books_reviewReview one calendar month's recorded income, spending, net, top categories/merchants and unusual alerts ('monthly review', 'how did last month go', 'what did I make and spend').Reads private dataReads text others writeNo findings

    Why it is in this group

    • The name "get_monthly_books_review" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "calendar": it reads calendars.
    • untrusted-inputThe name "get_monthly_books_review" says "get" and "review": it reads comments, which other people can write.
    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    Review one calendar month's recorded income, spending, net, top categories/merchants and unusual alerts ('monthly review', 'how did last month go', 'what did I make and spend'). Defaults to last completed month. Advisory estimates are not tax advice. closeReadiness gives recorded-book checks/Action Needed links; explain unknown coverage/limits. Never closes books or certifies tax completeness.

    Annotations the server declares

    • title: Review monthly books
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_per_tag_pnlPer-tag P&L — revenue, cost, profit, and margin grouped by tag (per-client, per-property, per-event, per-realtor-deal).No findings

    Why it is in this group

    • The name "get_per_tag_pnl" says "get": a word for reading.
    Description, as the server wrote it
    Per-tag P&L — revenue, cost, profit, and margin grouped by tag (per-client, per-property, per-event, per-realtor-deal). Requires both income AND expense rows to be tagged with matching labels. Examples: 'per-tag P&L this year', 'profit by client', 'profit by property', 'profit on the Smith wedding', 'per-client P&L this year vs last' (YoY). Supports YoY / MoM / QoQ comparison phrasing. Margin renders as multiplier in loss territory. Defaults to year-to-date if no date range given.

    Annotations the server declares

    • title: Get per-tag profit & loss
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_pnlCompute Profit & Loss (P&L / net income / margin) by combining the Income tab with expense tabs.Reads text others writeNo findings

    Why it is in this group

    • The name "get_pnl" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Compute Profit & Loss (P&L / net income / margin) by combining the Income tab with expense tabs. Examples: 'am I profitable this year', 'P&L for Q1', 'net income last quarter', 'what's my margin', 'P&L this year vs last' (YoY). Supports period comparison — YoY, MoM, QoQ, same-month-prev-year. Margin shows as a multiplier in loss (e.g. 'expenses 5.4x revenue'). Returns: { message, data: { revenue, expenses, netIncome, margin, comparison?, sampleMeta? } }.

    Annotations the server declares

    • title: Get profit & loss
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • get_recent_activityRead recent MCP assistant tool calls: tool, time, arguments and success, not document processing history.Reads private dataNo findings

    Why it is in this group

    • The name "get_recent_activity" says "get": a word for reading.

    What it can reach

    • private-dataThe description's first sentence says "read" and "document": it reads documents.
    Description, as the server wrote it
    Read recent MCP assistant tool calls: tool, time, arguments and success, not document processing history. Use for 'what did I do this week' or 'which tools has my assistant run'. Returns audit entries, default 20, max 100.

    Annotations the server declares

    • title: Show recent AI activity
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_report_detailsGet full details of a specific expense report including all expenses, totals, and compliance status.Reads text others writeNo findings

    Why it is in this group

    • The name "get_report_details" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Get full details of a specific expense report including all expenses, totals, and compliance status. Use only when the user explicitly asks to inspect an existing report's details. Without checkFreshness:true, returns the stored report only. When explicitly requested together with analysisRequested:true, freshness reads canonical Google Sheets sources with a 5-second bound; if full tax-year replay is unavailable, status is unknown, not current. Never call this as a preflight or follow-up to creating, sharing, or billing from a report; those tools already return the requested result and links.

    Annotations the server declares

    • title: Get report details
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • get_scan_statusCheck authoritative scan status; defaults to Gmail.No findings

    Why it is in this group

    • The name "get_scan_status" says "get": a word for reading.
    Description, as the server wrote it
    Check authoritative scan status; defaults to Gmail. provider:outlook reads gated mailbox status or exact jobId, not overall processing completion. Starts require the returned screen. Gmail returns the active lock, live phase/progress, queued or attention-needed periods, completed calendar years, tax-period statuses with their returned labels and inclusive ISO bounds, exclusions and recent outcomes. Use when asked if a scan is running, finished, stuck, or what it is doing. On completion show spreadsheetUrl or reviewExpensesUrl; for setup/reconnection show gmailScanUrl. Read-only.

    Annotations the server declares

    • title: Check Gmail scan status
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_setup_statusRead authoritative setup, known answers, next question and eligible actions for the current workspace.Reads text others writeNo findings

    Why it is in this group

    • The name "get_setup_status" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Read authoritative setup, known answers, next question and eligible actions for the current workspace. Ask only missing prerequisites; optional setup must not block a specific expense task. Unknown is not empty/complete. No client acting/writes.

    Annotations the server declares

    • title: Read setup status
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • get_spending_summarySummarize the user's recorded expenses with totals and breakdowns by category, merchant, month, tag, source, or payment method.No findings

    Why it is in this group

    • The name "get_spending_summary" says "get": a word for reading.
    Description, as the server wrote it
    Summarize the user's recorded expenses with totals and breakdowns by category, merchant, month, tag, source, or payment method. Supports date ranges, period comparisons, and total, count, or average metrics. Read-only. Income or profit questions: get_income_summary/get_pnl. Returns: { message, data: { total, breakdown?, comparison?, sampleMeta? } }.

    Annotations the server declares

    • title: Get spending summary
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_spreadsheet_urlReturn the master Google Sheet and authenticated workspace links, including Year-End.Reads text others writeNo findings

    Why it is in this group

    • The name "get_spreadsheet_url" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe name "get_spreadsheet_url" says "get" and "url": it reads web pages, which anyone can write.
    Description, as the server wrote it
    Return the master Google Sheet and authenticated workspace links, including Year-End. Show only 1–2 relevant links. Open spreadsheet: Sheet. Receipt added: Review expenses + Sheet; income added: Review income + Sheet. Receipts needing review: reviewReceiptsUrl. Held upload: use its Review files link. Gmail scan/connection: Scan Gmail. Bank/card: Reconcile. Configuration: Automation Hub/General Settings. Category/G/L/account codes: Category management. Client/project/trip groups: Group management. Personal classification: Personal rules. Client billing: use returned clientBillingHandoffs: manageClients, tagReadyExpenses, createClientReport. Named client grouping: search_expenses then group_expenses. Google Photos: authenticated picker with consent. Receipt storage: returned Drive folder only; never invent a folder ID. Complete unambiguous cash expense/mileage: direct write tool. Multiple/incomplete expenses, credits/refunds, tax/tip/per diem or visual review: Manual expense. Route/repeated/calendar/rideshare mileage, per diem or review: Mileage and travel. Income file without chat attachment or complex review: Import income (previews every row). Team setup: role-aware handoff; explain owner-access requirements. Complex reports: Create report. Read-only; no row changes.

    Annotations the server declares

    • title: Open ExpenseBot workspace links
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_statement_import_statusCheck 'Did my statement finish importing?' for at most five jobs.No findings

    Why it is in this group

    • The name "get_statement_import_status" says "get": a word for reading.
    Description, as the server wrote it
    Check 'Did my statement finish importing?' for at most five jobs. Returns status and authenticated review link. Extraction isn't saved; read/save jobs may overlap, so counts aren't statement totals. No job found doesn't prove no import; older non-job imports are excluded. Read-only: never uploads, parses, saves, retries, or recovers.

    Annotations the server declares

    • title: Check statement import status
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_subscription_auditFind recurring subscriptions, duplicate charges, price increases and trial-conversion suspects in recorded expenses, optionally by cost (e.g.No findings

    Why it is in this group

    • The name "get_subscription_audit" says "get": a word for reading.
    Description, as the server wrote it
    Find recurring subscriptions, duplicate charges, price increases and trial-conversion suspects in recorded expenses, optionally by cost (e.g. over $20/month). Returns message/data with recurring, duplicates, priceIncreases, trialConversions, totalMonthlyCost and sampleMeta.

    Annotations the server declares

    • title: Audit subscriptions
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • get_trip_suggestionsReview trips from the Review Expenses Find engine.Reads text others writeNo findings

    Why it is in this group

    • The name "get_trip_suggestions" says "get": a word for reading.

    What it can reach

    • untrusted-inputThe description's first sentence says "review": it reads comments, which other people can write.
    Description, as the server wrote it
    Review trips from the Review Expenses Find engine. Default is high-confidence only; for the trip list set includeCandidates:true (real trips first, second homes and regular spots grouped); page with offset while remaining > 0. Name a trip by destination (e.g. Copenhagen); mode:area lists expenses in a country or city. Show dates, recorded locations, count and uncertainty; locations are not travel or client proof. Copy exact selections to group_expenses with a user-chosen trip/client name and confirm:false, then request approval. Possible additions stay out unless the user includes them (includePossibleAdditions:true). Merge/deduplicate selections for one destination; separate destinations need separate confirmations. Preserve existing assignments, Personal and read-only rows. Never infer clients or countries from currency. clientEmail mode is read-only.

    Annotations the server declares

    • title: Review trip suggestions
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_categoriesList the user's configured expense categories and billing accounts.Reads text others writeNo findings

    Why it is in this group

    • The name "list_categories" says "list": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    List the user's configured expense categories and billing accounts. Use this BEFORE calling tools that need a category (add_cash_expense, add_mileage_entry, create_report) so you pass the user's actual category names, not guesses. Returns the live list from their spreadsheet.

    Annotations the server declares

    • title: List expense categories
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • list_client_close_readinessAccountant-only month-end overview of accepted client workspaces.No findings

    Why it is in this group

    • The name "list_client_close_readiness" says "list": a word for reading.
    Description, as the server wrote it
    Accountant-only month-end overview of accepted client workspaces. Returns page-level readiness and affected-client category counts with an authenticated Client Reports link. Use for 'how many clients need attention before month end'. No client identities, amounts, or individual items are returned; select a client in ExpenseBot to resolve items. Unavailable sources remain unknown. Each page uses the current roster; do not combine pages into a verified total.

    Annotations the server declares

    • title: Review client close readiness
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_client_invoicesList the user's issued client invoices (accounts receivable) — who owes them money, how much, and when it is due.No findings

    Why it is in this group

    • The name "list_client_invoices" says "list": a word for reading.
    Description, as the server wrote it
    List the user's issued client invoices (accounts receivable) — who owes them money, how much, and when it is due. Examples: 'which invoices are outstanding', 'what does Acme still owe me', 'any overdue invoices', 'how much am I waiting to get paid'. status accepts 'active' (default), 'open', 'overdue', 'needs_review', 'paid', 'void', 'superseded', or 'all'. Returns invoice numbers, status, totals by currency, delivery state, and private document links. Read-only.

    Annotations the server declares

    • title: List client invoices (AR)
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_income_categoriesList ExpenseBot's fixed income tax categories.No findings

    Why it is in this group

    • The name "list_income_categories" says "list": a word for reading.
    Description, as the server wrote it
    List ExpenseBot's fixed income tax categories. Unlike Expense Accounts, these are not user-configured. Use this BEFORE calling add_income so you pass an exact canonical category instead of guessing.

    Annotations the server declares

    • title: List income categories
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_reportsList the user's expense reports with pagination.No findings

    Why it is in this group

    • The name "list_reports" says "list": a word for reading.
    Description, as the server wrote it
    List the user's expense reports with pagination. Filter by status (All, Draft, Submitted, Shared). Each exact report includes its app, Bill Client, and accounting handoff URLs. Use the matching accounting URL only when the user explicitly asks to send or export that report; the app keeps organization, mapping, preview, and final confirmation.

    Annotations the server declares

    • title: List expense reports
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • list_tagsList the user's configured groups.No findings

    Why it is in this group

    • The name "list_tags" says "list": a word for reading.
    Description, as the server wrote it
    List the user's configured groups. ExpenseBot stores clients, projects, project codes, properties, and trips as tags (for example 'Client: Acme', 'Vegas Trip', or 'Property: 123 Main'). Use this when the user asks 'what groups/projects/clients do I have?' and before filtering, grouping, or reporting when the intended existing name is unclear.

    Annotations the server declares

    • title: List tags
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • search_expensesSearch spreadsheet expenses by category, merchant, dates, amount or tags.Reads text others writeNo findings

    Why it is in this group

    • The name "search_expenses" says "search": a word for reading.

    What it can reach

    • untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
    Description, as the server wrote it
    Search spreadsheet expenses by category, merchant, dates, amount or tags. When hasMore, reuse nextCursor with identical filters; avoid overlapping ranges. Optional query does deterministic non-embedding recall over merchant, city/location, Notes (e.g. receipt items, delivery source, payer or business purpose), Tag and category; ANDed with structured filters. Query examples: Tribeca restaurant, client dinner note. Results include matchedFields, matchReason and exact expenseId. expenseId is the exact durable Receipt ID for update_expense. paymentStatus is bookkeeping only, never bank settlement proof. For card/account nicknames use includePaidWith:true; page-only labels cannot filter all expenses. Country/client review: groupBy:country needs explicit YYYY-MM-DD bounds, at most 100 matches; narrow oversized ranges. Use configured travel categories; foreign locations do not prove travel. Keep unknown countries separate; ask about ambiguous places, never infer from currency. Country review allows categories/merchants/tags/countries/tagAssignment, no query or pagination. Show counts and per-currency totals; copy selectionItems (tag/date/location expectations) to group_expenses once a destination is chosen.

    Annotations the server declares

    • title: Search expenses
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: true
  • search_knowledgeSearch ExpenseBot's complete product and help knowledge base.No findings

    Why it is in this group

    • The name "search_knowledge" says "search": a word for reading.
    Description, as the server wrote it
    Search ExpenseBot's complete product and help knowledge base. Use this before guessing when the user asks how a feature works, what ExpenseBot supports, or needs setup, billing, Gmail, scan, report, workflow, or troubleshooting instructions. Set fullAnswer:true on the first call when the user asks for complete, detailed, or step-by-step instructions. Use the default excerpt mode for discovery and quick answers; if an excerpt is truncated, call again with fullAnswer:true before presenting complete instructions. Each result has a stable id.

    Annotations the server declares

    • title: Search ExpenseBot knowledge base
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false
  • trace_documentRead a receipt/invoice/forwarded email/Gmail receipt/PDF's lineage timeline: missing, skipped, income-routed, deduped or duplicate-removed documents.Reads private dataReads text others writeNo findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.

    What it can reach

    • private-dataThe name "trace_document" says "document": it reads documents.
    • private-dataThe description's first sentence says "read" and "email": it reads mail.
    • untrusted-inputThe description's first sentence says "read" and "email": it reads inbound email, which other people can write.
    Description, as the server wrote it
    Read a receipt/invoice/forwarded email/Gmail receipt/PDF's lineage timeline: missing, skipped, income-routed, deduped or duplicate-removed documents. Not Gmail scan-job status/progress/completion (running/queued/finished/stuck): use get_scan_status; a scan is not a document.

    Annotations the server declares

    • title: Trace what happened to a receipt or invoice
    • readOnlyHint: true
    • destructiveHint: false
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

128 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 1 outbound tool breaks every one.

Reads private data4
Reads files, mail, messages, databases, secrets, calendars or repositories.
Can send data out1
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
deny to break every path
{
  "permissions": {
    "deny": [
      "mcp__auth__send_report_to_accounting"
    ]
  }
}

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 20, 2026, 19:00 UTC, unchanged since Nov 6, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
31
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
not observed
RFC 9728 protected resource metadata
https://mcp.expensebot.ai/.well-known/oauth-protected-resource
Authorization servers
https://mcp.expensebot.ai
Legacy HTTP+SSE transport
no
Dynamic client registration
yes
Client ID metadata documents
no
  • HighThe whole server

    The endpoint served tools/list without credentials, and the list has 31 tools that change things (9 destructive, 2 irreversible, 20 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://mcp.expensebot.ai/mcp: tools/list returned 65 tools to an anonymous client, including complete_setup (destructive), create_report (destructive), share_report (destructive), fix_compliance (destructive), create_client_invoice (destructive) and 26 more

    What this check looks for

Posture changes

  1. Nov 6, 2026
    • Tools that change things, listed without credentials: 30 to 31
  2. Oct 29, 2026
    • Tools that change things, listed without credentials: 29 to 30

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "get_deep_analytics" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}; The name "get_deep_analytics" says "get": a word for reading.

    What this check looks for

History

Changes to its tool definitions and to its remote endpoint, newest first.

  1. Tools1 added, 33 changed.+1 added~33 changedView diff
  2. PostureRemote posture changed. Tools that change things, listed without credentials: 30 -> 31.View diff
    • Tools that change things, listed without credentials: 30 to 31
  3. Tools3 added, 40 changed.+3 added~40 changedView diff
  4. PostureRemote posture changed. Tools that change things, listed without credentials: 29 -> 30.View diff
    • Tools that change things, listed without credentials: 29 to 30

Install

Pinned to version 0.6.28. Values in angle brackets are yours to fill in.

claude mcp add --transport http auth https://mcp.expensebot.ai/mcp
claude mcp add --transport http auth https://mcp.expensebot.ai/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__auth__get_setup_status",
      "mcp__auth__search_expenses",
      "mcp__auth__get_spending_summary",
      "mcp__auth__list_reports",
      "mcp__auth__get_report_details",
      "mcp__auth__search_knowledge",
      "mcp__auth__get_last_receipt_result",
      "mcp__auth__get_accounting_integration_status",
      "mcp__auth__get_accounting_push_status",
      "mcp__auth__list_categories",
      "mcp__auth__list_tags",
      "mcp__auth__get_income_summary",
      "mcp__auth__get_pnl",
      "mcp__auth__get_per_tag_pnl",
      "mcp__auth__list_income_categories",
      "mcp__auth__get_recent_activity",
      "mcp__auth__trace_document",
      "mcp__auth__get_mileage_summary",
      "mcp__auth__get_subscription_audit",
      "mcp__auth__get_expense_by_id",
      "mcp__auth__export_report",
      "mcp__auth__get_spreadsheet_url",
      "mcp__auth__get_scan_status",
      "mcp__auth__get_statement_import_status",
      "mcp__auth__list_client_invoices",
      "mcp__auth__get_client_invoice",
      "mcp__auth__get_expense_splits",
      "mcp__auth__get_monthly_books_review",
      "mcp__auth__list_client_close_readiness",
      "mcp__auth__get_credits_refunds",
      "mcp__auth__get_client_advance_balances",
      "mcp__auth__get_trip_suggestions",
      "mcp__auth__search",
      "mcp__auth__fetch"
    ],
    "ask": [
      "mcp__auth__get_deep_analytics",
      "mcp__auth__request_accounting_integration",
      "mcp__auth__check_compliance",
      "mcp__auth__check_tax_deductibility",
      "mcp__auth__submit_receipt",
      "mcp__auth__add_cash_expense",
      "mcp__auth__parse_expense",
      "mcp__auth__process_gmail_receipts",
      "mcp__auth__scan_gmail",
      "mcp__auth__add_mileage_entry",
      "mcp__auth__add_income",
      "mcp__auth__add_income_from_file",
      "mcp__auth__add_income_from_csv",
      "mcp__auth__send_report_to_accounting",
      "mcp__auth__create_tag",
      "mcp__auth__check_feature",
      "mcp__auth__whatif_afford",
      "mcp__auth__whatif_client",
      "mcp__auth__whatif_tax_setaside",
      "mcp__auth__scan_gmail_years",
      "mcp__auth__prepare_client_invoice",
      "mcp__auth__omit_expenses"
    ],
    "deny": [
      "mcp__auth__complete_setup",
      "mcp__auth__create_report",
      "mcp__auth__share_report",
      "mcp__auth__fix_compliance",
      "mcp__auth__create_client_invoice",
      "mcp__auth__mark_client_invoice_paid",
      "mcp__auth__group_expenses",
      "mcp__auth__update_expense",
      "mcp__auth__correct_expenses"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as auth. Review it before you use it.

Capability tags behind 34 rules
  • mcp__auth__get_setup_status untrusted-input
  • mcp__auth__complete_setup untrusted-input
  • mcp__auth__search_expenses untrusted-input
  • mcp__auth__create_report untrusted-input
  • mcp__auth__request_accounting_integration untrusted-input
  • mcp__auth__get_report_details untrusted-input
  • mcp__auth__share_report untrusted-input
  • mcp__auth__fix_compliance untrusted-input
  • mcp__auth__submit_receipt untrusted-input
  • mcp__auth__add_cash_expense untrusted-input
  • mcp__auth__process_gmail_receipts untrusted-input
  • mcp__auth__scan_gmail untrusted-input
  • mcp__auth__add_mileage_entry untrusted-input
  • mcp__auth__add_income untrusted-input
  • mcp__auth__add_income_from_file untrusted-input
  • mcp__auth__add_income_from_csv untrusted-input
  • mcp__auth__get_accounting_integration_status untrusted-input
  • mcp__auth__send_report_to_accounting untrusted-input, outbound
  • mcp__auth__list_categories untrusted-input
  • mcp__auth__create_tag untrusted-input
  • mcp__auth__get_pnl untrusted-input
  • mcp__auth__get_recent_activity private-data
  • mcp__auth__trace_document private-data, untrusted-input
  • mcp__auth__get_expense_by_id untrusted-input
  • mcp__auth__get_spreadsheet_url untrusted-input
  • mcp__auth__scan_gmail_years untrusted-input
  • mcp__auth__get_client_invoice private-data
  • mcp__auth__create_client_invoice untrusted-input
  • mcp__auth__get_monthly_books_review private-data, untrusted-input
  • mcp__auth__get_trip_suggestions untrusted-input
  • mcp__auth__group_expenses untrusted-input
  • mcp__auth__update_expense untrusted-input
  • mcp__auth__correct_expenses untrusted-input
  • mcp__auth__omit_expenses untrusted-input

Pin

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://radar.anlyon.com/api/v1/servers/io.github.TotesMagotes/mcp-server-auth/verify?hash=0f1b658a3f8351c72313d79cb91c9f703ebaedabe6607d903dff3ca3568ca296" | jq -e '.changed == false'

Pinned hash 0f1b658a3f83, from Nov 11, 2026, 22:18 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://radar.anlyon.com/servers/io.github.TotesMagotes/mcp-server-auth/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

Anlyon Radar badge for io.github.TotesMagotes/mcp-server-auth
[![Anlyon Radar](https://radar.anlyon.com/badge/io.github.TotesMagotes/mcp-server-auth.svg)](https://radar.anlyon.com/servers/io.github.TotesMagotes/mcp-server-auth)

Source: MCP Registry · repository. Synced Nov 11, 2026, 22:17 UTC.

ExpenseBot MCP server: questions and answers

Answered from the scan above, not from the publisher's description.

Is the ExpenseBot MCP server safe?

No scan can promise that. What its definitions show: 65 tools, 31 of which can change, send or delete something, and 1 finding from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.

Can the ExpenseBot MCP server delete data?

Yes. 9 tools can delete, cancel or revoke something: complete_setup, create_report, share_report, fix_compliance, create_client_invoice, mark_client_invoice_paid and 3 more.

Can the ExpenseBot MCP server do things that cannot be undone?

Yes. 2 tools can send, pay, publish or merge: add_income and send_report_to_accounting.

What tools does the ExpenseBot MCP server have?

65 tools: 9 destructive, 2 irreversible, 20 write, 34 read. complete_setup, create_report, share_report, fix_compliance, create_client_invoice, mark_client_invoice_paid, group_expenses, update_expense and 57 more.

Does the ExpenseBot MCP server need sign-in or OAuth?

Its remote endpoint listed its tools to an anonymous client, without sign-in.

Does the ExpenseBot MCP server send data to outside services?

1 tool can carry data out (it sends, posts or publishes, or takes a recipient, channel or URL): send_report_to_accounting.

Has the ExpenseBot MCP server changed its tools?

Yes, 2 times since Anlyon Radar started tracking it, most recently on Nov 11, 2026. Every change is on this page and in its Atom feed.