fetch
ChatGPTGet the details and Firmary link for one search result (pass its id). Access is checked again. Returns record details only, with no document contents, form answers, tax IDs or payment details. Conversations can't be opened; use their link. Blank fields are unknown, not zero.
firmary_ask_document_approval
ChatGPTAsk an authorized client to approve the current version of one document they can already open (for example draft financial statements or a draft return), with an optional message and due date. The client's contacts who can open it are notified and answer Approve or Ask for changes in PocketFirm. A document has at most one open ask; share the document with the client first. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_assign_form
ChatGPTAssign one form to an authorized client with an optional due date. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_assign_tax_organizer
ChatGPTAssign one organizer template to an authorized client with safe prior-year prefill. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_assign_work
ChatGPTAssign one authorized task to a validated staff member or client contact. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_capabilities
ChatGPTLists what you can do in Firmary from this chat, by area of the firm: for each area, its read and manage tools with their operations, and the single-purpose Firmary tools. Pass query (a word or two, such as "invoice" or "checklist") to find the operations that match. Read-only reference: it runs no operation and changes nothing. Every call is still checked against the person's access and the firm's policy.
firmary_catalog_result
ChatGPTRetrieve the content of a firmary://catalog-results or firmary://operation-results or firmary://operation-run-results link returned by another Firmary tool.
firmary_change_my_name
ChatGPTChange the signed-in staff member's own display name when the firm lets staff edit their names or the member administers the firm. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_change_relationship_group_member
ChatGPTAdd or remove one client, contact, entity or subgroup. Adding a contact or entity does not add their clients. Needs unrestricted firm access. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_correct_relationship
ChatGPTCorrect a recorded relationship at its current revision with a reason. The previous values stay in its history. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_client_contact
ChatGPTAdd a person to one client as a contact without sending a PocketFirm invitation or creating a sign-in, such as a spouse who will not use PocketFirm or a dependent. Search first so the same person is not added twice; a person already on another client is associated with firmary_set_contact_client_association instead. Use firmary_invite_client_contact only for people who will use PocketFirm. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_document_checklist
ChatGPTCreate an ordered batch of document requests for one authorized client. For a checklist the firm reuses across clients, create a checklist form with firmary_create_form_version and assign it. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_document_request
ChatGPTAsk one authorized client for a document with optional instructions, due date and expected document (form, tax year, payer). Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_invoice_draft
ChatGPTCreate one reversible invoice draft for an authorized client. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_relationship_entity
ChatGPTCreate a business, trust, estate or other entity record, usually with clientId to place it on that client. Use it for a business the firm does not serve on its own, such as a single-member LLC reported on the owner's return. A business with its own return or work gets its own client instead. Record how it files in taxClassification, not in the description: sole_prop, single_member_llc, partnership, s_corp, c_corp, nonprofit, trust_estate or other, or llc for a multi-member LLC whose election is unknown. A multi-member LLC filing Form 1065 is partnership. kind stays business, trust, estate or other. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_relationship_group
ChatGPTCreate a named firm group, such as a family or business group. Needs unrestricted firm access. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_signature_request
ChatGPTSend accepted client documents to authorized signers through the configured e-sign adapter. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_time_entry
ChatGPTCreate a validated manual time entry for the delegated or authorized staff member. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_create_work
ChatGPTCreate an authorized client task with optional assignment, due date, estimate, engagement, or parent. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_end_relationship
ChatGPTRecord the last effective date of a relationship at its current revision with a reason. Ending keeps the record and removes no access. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_get_aged_ar_report
ChatGPTGet the authorized aged accounts-receivable report and bucket totals. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_client
ChatGPTGet one authorized client with contacts, invitations, tags, and custom fields. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_client_contact
ChatGPTGet one contact through an authorized active client membership. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_client_relationship_map
ChatGPTRead who a client is for (its subject) and the contacts, entities and relationships around it: at most 24 records and three levels, with a cursor for more and continuations to explore from. Records you cannot reach are left out. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_conversation
ChatGPTGet one conversation the caller can see, its participants, and cursor-paginated messages. Opening it marks it read for the caller unless markRead is false. Opening a conversation marks it read for you; it changes nothing else and sends nothing.
firmary_get_document_detail
ChatGPTGet one authorized document's current projection and folder summary. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_invoice
ChatGPTGet one authorized invoice with its current financial and delivery state. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_realization_wip
ChatGPTGet firm-wide and per-client realization and work-in-progress metrics for a bounded period. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_relationship
ChatGPTRead one relationship, its two records, current revision and visible history. Pass the revision to correct or end it. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_relationship_group
ChatGPTRead one named group you can reach and whether you can change it. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_relationship_setup
ChatGPTRead a client's access-review manager and the staff eligible for the role. Every relationship change touching a client needs a manager first; set one with firmary_set_relationship_review_manager. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_signature_status
ChatGPTGet one authorized signature request and its mirrored signer status. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_time_budget_actual
ChatGPTGet one authorized budget with actual minutes, amount, and utilization. Read-only: it changes nothing in Firmary and contacts no one.
firmary_get_work
ChatGPTGet one authorized task and its current details. Read-only: it changes nothing in Firmary and contacts no one.
firmary_instantiate_form_template
ChatGPTCopy one platform form starter into the firm and return its published form input. Pass that formInput to firmary_create_form_version to add the form to the firm's library. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_link_client_subject
ChatGPTRecord a client's subject: one contact (individual), one entity, or exactly two contacts for a joint client such as a married couple filing jointly. It is permanent. This is the last step of client setup: firmary_create_client, then firmary_set_relationship_review_manager, then this. A client created moments ago can take a few seconds to become reachable. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_list_appointments
ChatGPTList authorized appointments with client, status, and cursor filters. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_client_activity
ChatGPTList the durable activity timeline for one authorized client. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_client_documents
ChatGPTList accepted, non-archived documents for one authorized client. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_client_notes
ChatGPTList pinned-first staff-internal notes for one authorized client. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_client_tags
ChatGPTList the firm's client-tag catalog, with how many active clients you can see have each tag. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_clients
ChatGPTList authorized clients with filters, stable sorting, and cursor-based pagination. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_conversations
ChatGPTList the conversations the caller can see (a firm member's authorized client conversations, or a client's own threads with their firm) with status, unread, search, and cursor filters. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_document_requests
ChatGPTList authorized document requests with status, client, and cursor filters. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_invoices
ChatGPTList authorized firm invoices with status, client, search, and cursor filters. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_invoices_needing_attention
ChatGPTList authorized overdue, failed, and reconciliation-blocked invoices requiring staff action. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_proposals
ChatGPTList authorized proposals with client, status, and cursor filters, including proposals awaiting client acceptance. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_relationship_group_members
ChatGPTList a group's clients, contacts, entities and subgroups, direct and included. Members you cannot reach are left out, not counted. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_relationship_groups
ChatGPTList the firm's named groups, such as a family or business group, that include a record you can reach. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_signature_requests
ChatGPTList staff-visible signature requests with cursor pagination. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_tax_organizers
ChatGPTList authorized tax organizers with cursor pagination. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_time_budgets
ChatGPTList authorized active or archived client and engagement time budgets. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_time_entries
ChatGPTList authorized time entries with staff, client, work, billing, date, and cursor filters. Read-only: it changes nothing in Firmary and contacts no one.
firmary_list_work
ChatGPTList authorized firm and client work with filters and cursor pagination. Read-only: it changes nothing in Firmary and contacts no one.
firmary_operation_run
ChatGPTReturns the status (get) or the finished result (result) of one durable Firmary operation run started through a Firmary tool. It never changes the run.
firmary_operation_run_control
ChatGPTSends the person's answer to a durable Firmary operation run that is waiting for input (respond), or cancels the run (cancel).
firmary_product_help_read
ChatGPTReads Firmary help articles: how to use Firmary, from its help center. Read-only: it changes nothing and contacts no one. Exactly one operation: a JSON object (not a string) whose _operationType picks it, with that operation's fields beside it. Before an operation's first use, call firmary_tool_guidance with tool "firmary_product_help_read" and its _operationType: it returns what the operation does, its fields and schema, where ids come from, and its approvals. Operations (_operationType: what it does): - search_help: Search the Firmary Help Centre guides the signed-in person may read, by what they want to do.
firmary_record_mentions
ChatGPTFind up to 10 clients and 10 tasks by name to mention. Returns links only.
firmary_record_relationship
ChatGPTRecord one relationship between two contacts or entities: parent_of, spouse, sibling, owner_of (with an optional percentage and its meaning), controller_of, representative_of, trustee_of, or other with a label. Give the source and reason. Relationships grant no access. Every client the two records belong to needs an access-review manager. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_request_invoice_reminder
ChatGPTQueue a client-facing reminder for one authorized open invoice. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_search_relationship_participants
ChatGPTSearch the firm's contacts and entities by name, optionally only one client's. Use the returned type and id in subject, association, relationship and group tools; never treat a matching name or email as proof it is the same person. Read-only: it changes nothing in Firmary and contacts no one.
firmary_send_invoice
ChatGPTFinalize and deliver one authorized draft invoice to its client. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_send_message
ChatGPTSend a message in one conversation the caller takes part in, visible to the firm and the client. Firm members may instead add a staff-only note. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_client_work_status
ChatGPTShow the authorized firm's clients where their work stands in PocketFirm, or only what they need to act on. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_contact_client_association
ChatGPTRecord that an existing contact belongs with a client, with optional contact labels, or end that association. It is a fact only and grants no PocketFirm access. Needs the client's access-review manager to be set. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_entity_client_association
ChatGPTRecord that an existing entity record belongs with a client, or end that association. Needs the client's access-review manager to be set. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_relationship_review_manager
ChatGPTDesignate the staff member who gets the access-review task when this client's relationships change; choose from firmary_get_relationship_setup. Needed once per client before its subject or relationships can be recorded. A client created moments ago can take a few seconds to become reachable. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_relationship_review_managers
ChatGPTMake one staff member the access-review manager for up to 50 clients with a single approval instead of one per client; choose the manager from firmary_get_relationship_setup. Returns each client as set or failed. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_set_staff_name_editing
ChatGPTLet the authorized firm's staff change their own display names, or stop them. Firm admins can always change any member's name. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_setup_check
ChatGPTReturns where this connection is in Firmary’s setup and the next step to do: how the person chose for you to work (when they ask, when work arrives, on a schedule), and what’s left. Call it when the person asks you to set up Firmary, and again after each step. It changes nothing.
firmary_setup_report
ChatGPTRecords how a setup step went, so the person’s setup page in Firmary moves on: step is test, schedule or finish, and result is passed, failed or skipped. It returns the next step. Firmary shows the person only what it can confirm itself.
firmary_start_conversation
ChatGPTStart a conversation with an authorized client (firm members) or with the firm (a client, about their own account), and send its first message. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_task_work_hand_back
ChatGPTHands a task you're holding back to its person with a short summary: what you did, what you found and what's left. outcome is done, needs_input (someone has to answer or approve something) or not_done. The task's own status is left for its person, unless they let you complete it: then a done hand-back completes the task when Firmary's rules allow, and otherwise it goes to them for review.
firmary_task_work_start
ChatGPTHolds one waiting task for this connection for an hour and returns a claim token. Pass the same token again to keep holding it. Holding a task changes no client data; it goes back to waiting if the hold runs out.
firmary_tasks_to_work
ChatGPTLists the Firmary tasks handed to this connection to work: waiting ones and ones it's already working. Call this first on every run. Each task's own person reviews what you hand back.
firmary_update_staff_member
ChatGPTChange one tenant-scoped staff member's display name, whatever the firm's own-name setting; foreign or missing members are not found. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_update_work_status
ChatGPTMove one authorized task between open, in-progress, blocked, and done. Firmary checks the firm's policy on every call. If the person must approve first, the result has an approvalUrl and a confirmationId: share the link, then call this tool again with only that confirmationId.
firmary_work_automation_tasks
ChatGPTAfter you build and publish a Firmary automation that creates tasks, this returns the Firmary page where the person confirms handing those tasks to this connection, for one client or all. Show them the link. Once confirmed, each new task waits for you in firmary_tasks_to_work.
firmary_workspace
ChatGPTOpen the Firmary workspace to browse the clients, engagements, tasks, documents, forms, messages, signatures and billing you can access. Changes made in the workspace still go through Firmary's usual approvals.
search
ChatGPTSearch the clients, engagements, tasks, document requests, conversations, invoices and form submissions you can access. An empty query, or * alone, lists everything. Returns names and links, not contents. Each page covers one record type; if nextCursor is returned, call again with it to continue. coverage.unavailable means that record type couldn't be searched.
firmary_catalog_describe
Claudefirmary_catalog_preview
Claudefirmary_catalog_read
Claudefirmary_catalog_result
Claudefirmary_catalog_search
Claudefirmary_catalog_write
Claudefirmary_operation_run
Claudefirmary_operation_run_control
Claude