Back to the catalog

open-accountants

Global tax and accounting knowledge built with accountants around the world, with official sources and transparent authorship and review sta

Open source Open in the app JSON README (API)

About

Global tax and accounting knowledge built with accountants around the world, with official sources and transparent authorship and review status.

Details

Kind
Plugins
Topic
Finance & crypto
Publisher
openaccountants
Origin
gemini
Category
ferramentas
Version
1.0.0
Last push
2026-08-05T10:15:05Z
Repository state
ativo
License
MIT
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
openaccountants/gemini-cli-extension

README

# Open Accountants for Gemini CLI

**Global tax and accounting knowledge built with accountants around the world, with official sources and transparent authorship and review status.**

This extension connects Gemini CLI to the Open Accountants knowledge network, so
Gemini can answer tax and accounting questions from Guides that cite an official
source and carry an explicit review status, instead of from recall.

## Install

```bash
gemini extensions install https://github.com/openaccountants/gemini-cli-extension
```

Then confirm the server is connected:

```bash
gemini mcp list
```

No API key or configuration is needed to connect. Anonymous use is capped at a
small number of free questions, after which the server returns a sign-in prompt
with a link to create a free account. The Guides themselves are free to read.

### Direct install without the extension

If you would rather add the server on its own:

```bash
gemini mcp add --transport http open-accountants https://www.openaccountants.com/api/mcp
```

You get the tools this way, but not the `GEMINI.md` context that tells Gemini
when to use them and how to handle jurisdiction, sources and review status.

## What you get

As of 5 August 2026 the live network holds **1,790 Guides across 244
jurisdictions**: 188 country-level jurisdictions, 52 US state-level
jurisdictions, and 4 regional or cross-border groupings. Of those Guides, **188
carry an attestation from a credentialed
accountant**; the rest are accountant-authored or source-cited drafts. Coverage
per jurisdiction is uneven, and `list_jurisdictions` reports the per-jurisdiction
counts so you can see what is thin before you rely on it.

Topics covered: income tax, corporate tax, VAT/GST and sales tax, payroll, audit
and audit exemption, company formation and entity choice, capital gains, crypto,
tax residency, filing deadlines, and cross-border and relocation taxation.

## Example prompts

```
What VAT registration rules apply to a Maltese company selling services to
business customers in Germany?

Compare the tax treatment of a self-employed freelancer in Malta and Portugal.

What payroll records does a UK company need to retain, and for how long?

I am moving from the UK to the UAE in November. What are the tax consequences
on both sides?

Does my Irish company qualify for audit exemption this year?

Show me the accountant-written sources behind that answer.
```

## Tools

| Tool | What it does |
| --- | --- |
| `start` | Routes a tax question to the right Guides for the jurisdiction. Start here. |
| `start_help` | Explains how to frame a question for the best routing. |
| `search_rules` | Searches individual cited rules across jurisdictions. |
| `search_skills` | Full-text search across Guides. |
| `list_skills` | Lists Guides, filterable by jurisdiction and topic. |
| `get_skill` | Returns a complete Guide with its sources and review status. |
| `get_skill_sections` | Returns specific sections of a Guide. |
| `list_jurisdictions` | Shows coverage and Guide counts per jurisdiction. |
| `list_rule_facets` | Lists available topics, domains and roles for filtering. |
| `get_deadlines` | Filing and payment deadlines for a jurisdiction. |
| `check_audit_exemption` | Checks audit exemption thresholds for a company. |
| `validate_vat_number` | Validates an EU VAT number against VIES. |
| `list_verifiers` | Names the accountants behind the Guides, with credentials. |
| `share_with_openaccountants` | Sends a correction or a question to the network. User-initiated only. |

## How the Guides are written and reviewed

Guides are authored by accountants and carry one of three review states, which
the tools return with every result:

| State | What it means |
| --- | --- |
| Source-cited draft | Published with citations to official sources. No credentialed human has reviewed it. |
| Accountant-authored | Written by an accountant with a public licence number on file. |
| Attested by another accountant | A second credentialed professional has publicly stood behind that version. |

Verification is fact by fact, and the accountant who attests is named and
personally accountable. A cited official source proves where a rule came from,
not that it is still current. Confirm figures against the source before acting.

## Privacy and security

- **No credentials to configure.** The Guides are public and the server connects
  without a key. Anonymous use is capped at a small number of free questions,
  after which the server asks you to create a free account.
- **What is sent.** Only the query text your prompt produces (the topic and the
  jurisdiction). No files, no code, no credentials.
- **Read-only by default.** Thirteen of the fourteen tools only read. The one
  exception, `share_with_openaccountants`, sends a correction or a question to
  the network, and only when you explicitly ask for it.
- **Transport.** HTTPS to `https://www.openaccountants.com/api/mcp`.
- Full policy: https://www.openaccountants.com/privacy

## Not tax advice

Open Accountants is a research layer. It gives you the reviewed method, the
official source, and a named professional, which is more than a guess and less
than advice. Anything that ends in a filing position, a valuation, or a number a
tax authority will see should go past a qualified local accountant first.

## Links and support

- Website: https://www.openaccountants.com
- Browse the Tax Library: https://www.openaccountants.com/skills
- Add to other AI tools: https://www.openaccountants.com/connect
- Open-source Guides repository: https://github.com/openaccountants/openaccountants
- Support: info@openaccountants.com, or open an issue on this repository.

## Licence

Extension files in this repository: MIT. The Guides themselves are published
under the Open Accountants Guide License v1.0 in the
[main repository](https://github.com/openaccountants/openaccountants).

More