Query a MosoFin workspace
Read-only path for any MosoFin data question. Call only the MCP tools listed
in frontmatter. Full per-tool spec (inputs, outputs, examples, errors):
docs/mcp-tool-spec.md. Short contract: docs/plugin-contract.md.
Host-namespaced tool ids (Claude Code / Grok Build; plugin mosofin, server mosofin):
mcp__plugin_mosofin_mosofin__list_workspacesmcp__plugin_mosofin_mosofin__get_agent_datasourcesmcp__plugin_mosofin_mosofin__get_datasource_toolsmcp__plugin_mosofin_mosofin__invoke_datasource_api_tool
Native pickers may not appear (production MCP is stateless JSON). Ask in chat, then pass handles explicitly.
Steps
- Call
list_workspaceswith no arguments. - Show workspaces by name (and role). Never show integer tenant ids.
If several exist, ask single- vs multi-workspace, then which name(s), and
confirm with
list_workspaces(workspace_ids=[…], mode="single")ormode="multi". One accessible workspace auto-confirms server-side — still read the name back and wait for an explicit yes before invoking data tools. - Call
get_agent_datasourcesfor the confirmedworkspace_id.- Refer to companies by
display_name. Never show rawdata_source_id. - If more than one row for a platform is
connected: true, ask which company, then pass thatdata_source_idon every later call. - If the needed source is
connected: false, stop. Tell the user to open thereconnect_urlfrom a later error, or the MosoFin workspace data-sources page. Do not invent numbers.
- Refer to companies by
- Call
get_datasource_toolsfor the chosen datasource (anddata_source_idwhen required) to pick a validtool_name. - Call
invoke_datasource_api_toolwith:datasource(e.g.quickbooks)tool_namefrom the catalog (e.g.get_profit_and_loss)workspace_id(opaquews_…handle) on every calldata_source_idon every call when the workspace has multiple companiesparamswith concreteYYYY-MM-DDdates — resolve "last month" / "this quarter" before invoking. Transaction searches and period reports need bothstart_dateandend_date. As-of reports (get_balance_sheet,get_aged_receivables, …) take an optionalreport_date(default today). Get-by-id tools needid. Multiple independent invokes may run in parallel in one turn.
Result handling
- Pagination (search tools): if
pagination.has_moreis true, re-invoke withparams.offset = pagination.next_offsetuntil complete or the user has enough. Omitmax_resultsunless a smaller page is needed. - Budgets are two-step:
search_budgetsto list names, thenget_budget_detailswithbudget_idorbudget_name. mockflag:falsemeans live numbers — say so.truemeans demo/fixture data — tell the user the numbers are not real.
Read-only boundary
MosoFin cannot create, update, send, or delete records in any connected
accounting platform or other SaaS. If asked to (e.g. "create an invoice"), do not invoke — explain
the boundary and offer the read equivalent (e.g. search_invoices).
Errors
- Unknown tool / MosoFin tools missing — connector not enabled for this
chat. Never say "refresh/reconnect". Give ChatGPT/Codex setup: Settings →
Apps & Connectors → create MosoFin at
https://mcp.mosofin.com/mcpwith OAuth → sign in → new chat with MosoFin turned on. Claude Code / Grok Build: installmosofin@financehub. Then retry. Do not invent data. - Workspace not confirmed — confirm via
list_workspacesthen retry. entity_required— ask which company fromentities[]; retry with thatdata_source_id.datasource_not_active/connection_unavailable— give the userreconnect_url. Do not guess data.invalid_params— fix dates/fields and retry.approval_required— ask the user, then retry withapproved=true.tool_policy_disabled/ valid-access refusal — explain; do not leak or invent data.
Grounding
Answer only from invoke results in this conversation. Do not use general
knowledge or another company's memory. End data-backed answers with one
Data sources line (datasource + tool + fetched_at from provenance).
If the fetch does not cover part of the question, say so and name the tool
that could fetch it.