← Back to PortfolioCase Study · Portfolio · v0.1.0

Tax-MCP

Local-first AI agent for filling out the Italian tax return. MCP protocol, Rust, Yew/WASM, and offline RAG on SQLite FTS5. Bring Your Own Model.

Discuss a similar projectRead the case study
Stack

Rust · Axum · Yew/WASM · SQLite FTS5

Protocol

MCP (stdio JSON-RPC) + WebSocket

Status

v0.1.0 · Freeware personal use

B2B License

On request

Architectural choices

Engineering Decisions

  1. MCP as an IPC contract. Stdio JSON-RPC between LLM and Axum backend. All logging is confined to stderr, so traces never corrupt the protocol stream.
  2. RAG on SQLite FTS5, no vector DB. Ministerial instructions are sliced by section/line and full-text indexed. Millisecond searches, zero tokens wasted on context bloat or tax hallucinations.
  3. Shared Rust crate for validation. The same regexes for fiscal codes, VAT numbers, and rigid formats compile in both Axum and WASM (Yew). The LLM receives descriptive errors and self-corrects in a loop.
  4. Zero automation towards the Public Administration. Tax-MCP generates a filing guide; the user pastes it manually into the Italian Revenue Agency (Agenzia delle Entrate) portal. No scraping, no automated logins, no criminal risk under art. 615-ter.

For implementation details — trade-offs, mistakes made, product reasoning — read the full case study.

Download

Tax-MCP v0.1.0

Freeware for personal use (individuals and VAT holders for their own tax returns). For professional firms, tax assistance centers (CAF), and SaaS integrations, a dedicated commercial license is required: contact me.

End User License Agreement (EULA) and Terms of Use

Product: Tax-MCP · Updated: 28/05/2026

READ CAREFULLY BEFORE DOWNLOADING, INSTALLING, OR USING THE SOFTWARE.

Downloading, installing, or using the Software constitutes unconditional acceptance of these Terms of Use. If you do not accept these terms, do not download or use the Software.

1. Grant of License (Freeware for Personal Use)

The Software is licensed, not sold. The Author grants the User a limited, non-exclusive, non-transferable, and revocable license to install and use the Software solely for personal and direct use.

They are considered "Personal Use":

  • Use by natural persons (private citizens) for the preparation of their own tax returns.
  • Use by self-employed workers, sole proprietorships, or freelancers (VAT holders) for the completion of their own exclusive tax return.
2. Restrictions and Prohibition of Commercial Use / Third-Party Accounts

The Software is NOT free for commercial use or for providing services to third parties.

Without the prior written consent of the Author and the purchase of a dedicated commercial license, it is strictly forbidden to:

  • Use the Software to process, prepare, or compile tax returns on behalf of clients (absolute prohibition for Accountants, Tax Experts, Tax Assistance Centers (CAF), Labor Consultants, etc.).
  • Integrating the Software into commercial SaaS solutions or business service offerings.
  • Distribute, sublicense, sell, rent, decompile, or reverse engineer the Software, or attempt to extract its source code (including JSON templates and the FTS5 Knowledge Base).

For commercial license requests, B2B, or integrations for professional firms, contact the Author directly.

3. No Affiliation and Absence of Automation with the Public Administration (P.A.).

The Software is an independent tool. The Author is not in any way affiliated, associated, authorized, or endorsed by the Italian Revenue Agency (Agenzia delle Entrate) or any other Italian Public Administration entity.

The Software acts as a local "sandbox". It DOES NOT interact, DOES NOT connect, and DOES NOT perform any automated operations (scraping, bot, login) on Public Administration portals. The Software is limited to generating a "Completion Guide" that the User must manually enter and validate on official channels.

4. Privacy and "Bring Your Own Model" (BYOM) Architecture

The Software operates locally on the User's device. By default, the Software does not collect, store, or autonomously transmit the User's tax data to third parties.

However, the use of the Software requires the integration of a Large Language Model (LLM). The User understands and agrees that:

  • Data Transfer Responsibility: If the User chooses to connect the Software to third-party cloud service APIs (e.g., OpenAI, Anthropic, Google), the User agrees to transmit their own tax and sensitive data to such companies' servers, subject to their privacy policies. The Author disclaims all responsibility for data management by these external providers.
  • Recommendation (Privacy by Design): It is strongly recommended to use the Software exclusively in combination with locally executed LLMs (e.g., via Ollama) to ensure that tax data never leaves the User's device.
5. Disclaimer of Warranties ("AS IS") and AI "Hallucinations"

THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED.

The User is aware that the Software uses technologies based on Artificial Intelligence (LLM), which are inherently subject to errors, logical inaccuracies, and "hallucinations" (invention of non-existent data or regulations).

The validation systems integrated into the Software and the search in the manuals (Knowledge Base) are not infallible. The Software does not provide tax, legal, or accounting advice.

6. Limitation of Liability and Obligation for Human Validation

The tax return is a strictly personal legal obligation. The User is the sole and only person responsible for the accuracy, completeness, and truthfulness of the data entered, calculated, and ultimately transmitted to the Revenue Agency.

In no event shall the Author be held liable for:

  • Direct, indirect, incidental, or consequential damages.
  • Fines, penalties, assessments, late fees or interest resulting from compilation errors, delays or omissions caused by the use of the Software.
  • Erroneous interpretations of tax regulations generated by the AI or provided by the Software.

The User accepts that the burden of the final human review, before the final submission of the data (via the manual copying procedure of the "Filling Guide"), falls solely on them.

7. Resolution

This License is effective until its termination. The Author reserves the right to revoke the license immediately and without notice in the event of a breach of any of the terms described herein (with particular reference to unauthorized commercial use). Upon termination, the User must cease all use of the Software and destroy all copies of it.

8. Applicable Law and Competent Jurisdiction

These Terms are governed by and construed in accordance with Italian Law. Any dispute arising from, or related to, this EULA shall be under the exclusive jurisdiction of the Author's place of residence.

Accept the EULA above to activate the download buttons.
🪟

Windows

x86_64 · .exe
🍎

macOS Apple Silicon

arm64 · binary
🍎

macOS Intel

x86_64 · binary
🐧

Linux

x86_64 · binary
Companion: the system prompt to paste into your LLM to guide the interview.
Found a bug?

Report it: every report makes Tax-MCP more robust.

Include version, operating system, LLM used and, if possible, the stderr logs. I will respond as soon as possible.

📨 Write to [email protected]
For companies and organizations

I build custom on-premise AI infrastructures

Custom MCP servers to integrate your internal tools with any LLM, high-performance Rust backend, and compliance solutions for the Italian market. If Tax-MCP intrigues you, imagine what we could build for your domain.

Start a conversation