Mercury CLI / MCP — Build Optimizations

Filtered for what actually accelerates builds — current and new. Source: Mercury developer announcement, Apr 28, 2026.

Generated: 2026-04-30 Owner: BOSSTORQUE Internal Tag: Tech Stack · Optimization
Read-only
Hosted MCP scope
Write
CLI + direct API only
OAuth 2.0
Dynamic client reg
Already loaded
Mercury MCP in Cowork
Critical correction. Mercury's hosted MCP (the one currently connected in Cowork) is read-only — confirmed in the official MCP setup doc. The "send money / categorize / invoice / upload receipt" capabilities advertised in the email are only via the new CLI or direct API. Plan accordingly: don't promise write automations through the MCP path.

1. Mercury-specific speedups (BOSSTORQUE)

BuildCurrent painOptimizationPathTime saved
Monthly close / P&LManual export, sort, classify in QuickenScheduled Cowork task pulls last 30d txns via Mercury MCP, AI-categorizes, drops HTML P&L in outputsMCP read~2 hrs/mo
Cash-flow watchCheck balances by hand, no upcoming-AP visibilityDaily scheduled pull of balances + pending Send Money requests; Dispatch ping if balance < thresholdMCP read~30 min/wk + miss-prevention
Invoice sendBuild invoice in UI, copy to email, sendGenerate from project notes, push via Mercury CLI (mercury invoices create), Dispatch-gated sendCLI write20–30 min/invoice
Receipt attachManual upload one-by-oneForward receipts to inbox → Gmail MCP fetches → match by amount/date → CLI uploadCLI write~1 hr/mo
Vendor paymentQuicken bill pay or manual transferCowork drafts the Send Money request; you approve in Mercury UI (CLI can stage, never auto-execute)CLI + Jason approves~10 min/payment
Quarterly tax estimatePull P&L from books, compute by handCowork pulls 90d txns + categories, runs estimate via tax skill, HTML deliverableMCP read~1 hr/qtr

2. Pattern speedups (apply to every client build)

The Mercury announcement is one instance of a broader pattern: vendor-shipped MCPs and CLIs collapse the build cost of integrations from days to hours. The optimizations below are reusable across BOSSTORQUE deliverables, not just Mercury.

1. Read-MCP-first, write-via-CLI escalation

For any vendor that ships both: use the MCP for autopilot read flows, route writes through CLI gated by Dispatch confirmation. Same pattern for Jobber, ServiceTitan, QuickBooks, ConvertKit, Apollo. Lock the standard, copy-paste across clients.

2. CLI install once, reuse forever

Cowork's bash sandbox can run any CLI. Maintain a setup.sh per client/project that curl|sh's required CLIs on first session boot. Mercury, gh, wrangler, supabase, stripe — same pattern.

3. OAuth 2.0 dynamic client reg

Mercury supports it. So do most modern vendors now. For client deliverables that need persistent automated access, register a BOSSTORQUE-named OAuth client per vendor — beats raw API keys, professional in audit trails, survives password changes.

4. Doc-digest subagent pattern

Vendor docs often blow past context limits (this Mercury MCP doc was 102K chars). Standard play: dispatch a Haiku subagent to fetch + summarize, return the 5 facts that matter. Cuts main-context burn ~80% per vendor onboarding.

5. Scheduled task = recurring deliverable

Anything you'd otherwise do manually each month (close, status report, cash-flow check, client digest) becomes a scheduled task. MCP read-only flows are the safest first candidates — no write blast radius.

6. New-connector intake checklist

Standard 30-min playbook when any vendor MCP/CLI lands: (1) test auth, (2) enumerate read scopes, (3) enumerate write scopes, (4) note rate limits, (5) update memory glossary, (6) flag which existing builds it accelerates. Treat each new MCP as a build-cost reduction event.

3. Standards locked in

StandardRule
Mercury MCP scopeRead-only. Use freely on autopilot — accounts, balances, transactions, invoices, recipients, treasury, statements, send-money approval requests.
Mercury CLIWrite actions live here. Install once on Mac via curl -sSf https://cli.mercury.com/install.sh | sh. Cowork invokes via Desktop Commander.
Money movementCLI can stage Send Money requests. Never auto-execute. Always Dispatch + Jason confirms in Mercury UI. Aligns with global "no trades / no transfers" rule.
Categorization, invoice draft, receipt uploadLow-risk writes. Dispatch the summary of what was done, not a pre-approval gate. Drafts are reversible.
OAuth client registrationName BOSSTORQUE clients Mercury MCP for BOSSTORQUE per Mercury's convention. Token storage: 1Password, never repo.
Sandbox vs prodDefault all new write-flow development to sandbox; promote only after Jason signs off.

4. Action items (ranked by ROI)

  1. Install Mercury CLI on Mac (you, ~30 sec). Run curl -sSf https://cli.mercury.com/install.sh | sh. Unlocks every write-side optimization. unblocks 4 builds
  2. Stand up the monthly-close scheduled task. Mercury MCP read → AI categorization → HTML P&L. ~2 hrs/mo recovered, no write-side risk.
  3. Add mercury.md to memory + hot cache. Locks in the read/write split so we don't relitigate it every session.
  4. Build the cash-flow watch task. Daily balance pull, low-balance Dispatch alert. Costs nothing, prevents missed AP.
  5. Roll the "new-connector intake checklist" into connectors.md. Pays back the next time any vendor ships an MCP — which is now monthly.
  6. Decide on BOSSTORQUE-owned OAuth client. Worth doing if we plan to ship Mercury-integrated client deliverables. Skip if internal only.
  7. Pin a CLI version. Repo lives on next branch — pin to a tagged release once stable, don't track HEAD in production scheduled tasks.

5. Link audit (the email itself)

LinkWhat it isAction
docs.mercury.com/docs/connecting-mercury-mcpHosted MCP setup, OAuth dynamic client reg, scope notesRead once, reference. Already extracted key facts.
github.com/MercuryTechnologies/mercury-cliCLI source + install. README on next branch.Install when convenient. Pin version when stable.
docs.mercury.com/docs/welcomeGeneral API/dev docsReference only. No new info beyond MCP doc.
mercury.com/apiMarketing landing for the dev suiteSkip. Marketing.
Track/customer.io unsubscribe + socialMarketing telemetryIgnore.
Bottom line. The biggest single optimization is just running the install one-liner. Once the CLI is on your Mac, four BOSSTORQUE workflows (close, invoicing, receipts, payments) move from manual-UI to scheduled-task with Dispatch gating. The pattern then ports verbatim to any future client build that touches Mercury, QB, Jobber, Stripe, or anything else that ships an MCP this year.