Skip to content
MCP server

ANAF SPV

Read and keep ANAF SPV inbox documents, request papers and validate or file declarations

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.3
Listing updated
3 days ago

About ANAF SPV

ANAF SPV is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "anaf-spv": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-anaf-spv"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ANAF_SPV_USERNAMEYour SPV user name, when the password comes from a file.
  • ANAF_SPV_PASSWORD_FILEPath of a file holding your SPV password. The README also shows how to read it from a vault MCP server instead.
  • ANAF_SPV_MAIL_MCP_URLA mail MCP server over Streamable HTTP that reads the mailbox SPV sends its codes to, so a sign-in reads the code by itself. Without one (or a command below), every sign-in asks you for the code.
  • ANAF_SPV_MAIL_MCP_TOKEN_FILEPath of a file holding that mail server's bearer token, if it wants one.
  • ANAF_SPV_MAIL_MCP_COMMANDInstead of a URL: a mail MCP server to start over stdio, as a JSON array such as ["npx","-y","some-mail-mcp"].

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

submit_declaration
Files a declaration; the client asks before each call

What it does

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

Pricing

Open source

Free npm package (@foreverworks/mcp-anaf-spv); prices not published.

Prices change. Check foreverworks.github.io before you buy.

ANAF SPV 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 to ANAF SPV

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments