# ANAF SPV

> ANAF SPV is an open-source MCP server for finance and payments. Read and keep ANAF SPV inbox documents, request papers and validate or file declarations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://foreverworks.github.io/mcps/servers/anaf-spv/
- **Repository:** https://github.com/foreverworks/mcps/tree/HEAD/servers/anaf-spv
- **MCP Registry name:** com.foreverworks/anaf-spv
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-14

## About

Romania's tax authority offers no API for an individual's Spatiul Privat Virtual account, so this server reads the SPV web pages instead. It is marked beta and exposes 16 tools. The README says nothing moves money: the one tool marked as money, submit_declaration, files a declaration, and the client asks you before each call.

Beyond downloading decisions, summonses, notifications and payment confirmations into a folder, it can request documents such as an obligations-to-pay statement, send messages through SPV's contact form (a dry run unless you say otherwise), validate declarations with ANAF's own validator and file a D212. Validation needs Java 8 or newer.

It needs an SPV account for a natural person that signs in with a username and password rather than a qualified certificate. Passwords come from a file or a vault MCP server, and a mail MCP server can read the sign-in codes SPV emails, otherwise you type each code. It runs on Node 22.19 or newer.

## Features

- **Inbox download:** Saves what ANAF posts to SPV, including decisions, summonses and notifications.
- **Document requests:** Asks ANAF for documents and saves them when they arrive.
- **Declaration validation:** Checks files such as a D300 with ANAF's validator.
- **D212 filing:** Files a D212 declaration through submit_declaration, with client confirmation.
- **Dry-run contact form:** Messages to ANAF are a dry run unless you say otherwise.
- **Vault and mail integration:** Reads the password from a vault MCP server and sign-in codes from a mail MCP server.

## Good for

- Check for new ANAF notices without opening SPV
- Save every unsaved SPV document to a dated folder
- Validate a monthly VAT declaration file before filing
- Look up the status of a filing by its reference

## Install

### Claude Code (Terminal)

```sh
claude mcp add anaf-spv -- npx -y @foreverworks/mcp-anaf-spv
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "anaf-spv": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
```

## Tools

- `submit_declaration`: Files a declaration; the client asks before each call

## FAQ

### Is there an official ANAF API for this?

No. The README says ANAF has no API for such an account, so the server reads SPV's web pages.

### What account type is supported?

A personal SPV account that signs in with a username and password, not a qualified certificate.

### Can it move money?

The README says nothing moves money. submit_declaration files a declaration, and your client asks before each call.

### How are sign-in codes handled?

A mail MCP server can read them automatically; without one, you type each code.

### Is ANAF SPV free?

Yes. ANAF SPV is open source, so you can use and self-host it for free.

### How do I add ANAF SPV to Claude Code?

Run this command in your terminal: claude mcp add anaf-spv -- npx -y @foreverworks/mcp-anaf-spv

### What are the best alternatives to ANAF SPV?

The closest alternatives to ANAF SPV are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/anaf-spv
