mothermachine

Browse / Support and bookkeeping

OpenAccountants

Accountant-reviewed tax and bookkeeping guides served to any agent over MCP; edit the skills, self-host the server.

AdaptableOperable SkillSkill Deterministic PythonMarkdown MCP server License: AGPL-3.0

OpenAccountants is a repo of 1,800+ markdown guides across 233 jurisdictions (tax, bookkeeping, payroll, e-invoicing, formation, financial statements) with named licensed accountants signing reviews. A hosted MCP at openaccountants.com/api/mcp is the product; a self-hosted Python MCP (pip openaccountants-mcp) serves the same open guides read-only through six tools. The guides under skills/ are the customization surface.

Use it when
  • our agent keeps guessing at sales tax rates and filing rules and we want it to cite a guide a named accountant signed
  • we are a bookkeeping firm and want to add our own jurisdiction or client-type guides and serve them to staff agents privately
Gotchas
  • Code is AGPL-3.0 but guide content is under the OpenAccountants Guide License v1.0 with commercial terms in COMMERCIAL-LICENSING.md; check before redistributing
  • Hosted server is the product and has a larger tool surface than the self-hosted one
  • Knowledge, not a ledger: it does not do bookkeeping, it tells the agent how
  • Pricing page returned 404; hosted tiers unknown

Last activity Sep 2, 2026. Fit: adaptable 2, operable 3.

Editions

Free (self-hosted MCP and open guides) · Free open source

  • Clonegit clone https://github.com/openaccountants/openaccountants
  • Installpip install openaccountants-mcp

Hosted connector · Free closed source

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Config only6 things to edit

Edit or add markdown guides under skills/ (for example skills/federal/us-1099-nec-issuance.md or a jurisdiction folder); packages/, index.json, and llms-full.txt regenerate nightly and must not be hand-edited. Self-hosting the MCP means pip install and pointing it at your checkout; it is read-only and path-sandboxed to packages/. There are no env vars in the README; an agency adapting this would add its own vertical guides and run the local server.

Env vars
none
Config files
index.json (generated) mcp/server.json
Prompt files
skills/**/*.md skills/federal/us-1099-nec-issuance.md skills/verticals/ skills/integrations/
Accounts you need
OpenAccountants account for the hosted connector and accountant handoff

Source

Operable: what an agent can drive

Interface

NativeMCP serverpublished by the builderremote or local

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs
www.openaccountants.com/api/mcp
Tools
start list_skills get_skill get_skill_sections search_skills submit_feedback

Reach

Partial coverage. 7 of 9 jobs reachable through the stated interface.

JobThrough the interfaceEvidence
Plan which guides apply to a question and jurisdictionReachablestart tool returns skills_to_load, expectations, next_action, guardrails
Load a full guide or its sectionsReachableget_skill, get_skill_sections
Search guides by keywordReachablesearch_skills, up to 25 matched sections
List guides with review tier and reviewerReachablelist_skills with jurisdiction and category filters
Get current rates and compare jurisdictionsReachablehosted server only: get_rates, compare_jurisdictions, plan_cross_border
Hand off to a named licensed accountant for reviewReachablehosted server only: request_accountant_review
Submit feedback on a guideReachablesubmit_feedback builds a GitHub issue URL; no server-side write
Post entries to a ledger or reconcile a bank feedNot reachableread-only knowledge server; _integrations package gives export formats for Xero, QuickBooks, Stripe but no write tools
File a return or make a paymentNot reachableREADME: general reference, not advice; no filing tools

Code stack

Languages
PythonMarkdown
Frameworks
MCP Python SDK
Package manager
pip / uv
Database
none
Hosting target
local stdio (pip)hosted at openaccountants.com
Built
Mixed (recorded, never ranked)

Model stack

Providers
any MCP client
Models
none
Keys you need
none
Prompts live in
skills/**/*.md packages/ (generated)

Skills

Skill pack is the product; the MCP server only serves the same skills to agents that cannot install them locally.

Kind
pure
Paths
agent-skills/*/SKILL.md skills/*/SKILL.md
Install
/plugin marketplace add openaccountants/openaccountants

Evidence and confidence

FieldWhere it was seenConfidence
formFactormcp/ directory with a Python MCP server on PyPI; hosted endpoint in README90%
executionModelserver reads markdown; no model calls in the server85%
operabilityREADME: hosted connector URL and self-hosted pip server; mcp/README.md lists six tools and the hosted superset95%
effortREADME Contributing: edit skills/** only; everything else regenerates80%
editionsREADME: self-host with pip is free; hosted connector at openaccountants.com/connect; commercial licensing file for content60%
activegh api: pushed 2026-09-02; README stats updated 2026-09-02 by nightly sync–
reach90%

Open questions

  • Hosted connector pricing and free-tier limits
  • Exact terms of the Guide License v1.0 for a firm serving guides to clients
  • Provenance: guides are drafted from legislation, some AI-assisted; README does not say

Sources