ANAF SPV — Claude Code MCP server: features and setup
The ANAF SPV MCP server for Claude Code retrieves documents from an SPV inbox and sends requests to ANAF. It can also validate declarations and file D212.
MIT ★ 5 updated 2026-10-29
claude mcp add --env ANAF_SPV_USERNAME=<ANAF_SPV_USERNAME> --env ANAF_SPV_PASSWORD_FILE=<ANAF_SPV_PASSWORD_FILE> --env ANAF_SPV_MAIL_MCP_URL=<ANAF_SPV_MAIL_MCP_URL> --env ANAF_SPV_MAIL_MCP_TOKEN_FILE=<ANAF_SPV_MAIL_MCP_TOKEN_FILE> --env ANAF_SPV_MAIL_MCP_COMMAND=<ANAF_SPV_MAIL_MCP_COMMAND> --transport stdio anaf-spv -- npx -y @foreverworks/mcp-anaf-spvWhat ANAF SPV does
The server reads notices and files ANAF delivers to an SPV account, including payment confirmations. It can ask ANAF for a document and save it when it arrives. Messages sent through the contact form run as a dry run unless explicitly enabled.
It validates declarations and files D212; the client asks for confirmation before each filing. Sign-in requires an SPV account for an individual that uses a username and password. The password comes from a file or a vault MCP server. A mail MCP server can retrieve sign-in codes; otherwise, someone enters each code manually. Declaration validation requires Java 8 or newer. ANAF offers no API for this account type, so the server reads SPV web pages.
What it helps with
- retrieve new notices and files from an SPV inbox
- request a statement of amounts owed to ANAF
- validate a declaration and file D212
Example prompts for the agent
- Show me new messages from ANAF in my SPV inbox.
- Request my statement of amounts owed and save it when it arrives.
- Validate
d300-2026-09.xmland tell me the VAT payable.
How to install ANAF SPV
Platform CLI
claude mcp add --env ANAF_SPV_USERNAME=<ANAF_SPV_USERNAME> --env ANAF_SPV_PASSWORD_FILE=<ANAF_SPV_PASSWORD_FILE> --env ANAF_SPV_MAIL_MCP_URL=<ANAF_SPV_MAIL_MCP_URL> --env ANAF_SPV_MAIL_MCP_TOKEN_FILE=<ANAF_SPV_MAIL_MCP_TOKEN_FILE> --env ANAF_SPV_MAIL_MCP_COMMAND=<ANAF_SPV_MAIL_MCP_COMMAND> --transport stdio anaf-spv -- npx -y @foreverworks/mcp-anaf-spvReplace <…> with your own values
Platform CLI
codex mcp add anaf-spv --env ANAF_SPV_USERNAME=<ANAF_SPV_USERNAME> --env ANAF_SPV_PASSWORD_FILE=<ANAF_SPV_PASSWORD_FILE> --env ANAF_SPV_MAIL_MCP_URL=<ANAF_SPV_MAIL_MCP_URL> --env ANAF_SPV_MAIL_MCP_TOKEN_FILE=<ANAF_SPV_MAIL_MCP_TOKEN_FILE> --env ANAF_SPV_MAIL_MCP_COMMAND=<ANAF_SPV_MAIL_MCP_COMMAND> -- npx -y @foreverworks/mcp-anaf-spvReplace <…> with your own values
Config file
{
"mcpServers": {
"anaf-spv": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-anaf-spv"
],
"env": {
"ANAF_SPV_USERNAME": "<ANAF_SPV_USERNAME>",
"ANAF_SPV_PASSWORD_FILE": "<ANAF_SPV_PASSWORD_FILE>",
"ANAF_SPV_MAIL_MCP_URL": "<ANAF_SPV_MAIL_MCP_URL>",
"ANAF_SPV_MAIL_MCP_TOKEN_FILE": "<ANAF_SPV_MAIL_MCP_TOKEN_FILE>",
"ANAF_SPV_MAIL_MCP_COMMAND": "<ANAF_SPV_MAIL_MCP_COMMAND>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"anaf-spv": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-anaf-spv"
],
"env": {
"ANAF_SPV_USERNAME": "<ANAF_SPV_USERNAME>",
"ANAF_SPV_PASSWORD_FILE": "<ANAF_SPV_PASSWORD_FILE>",
"ANAF_SPV_MAIL_MCP_URL": "<ANAF_SPV_MAIL_MCP_URL>",
"ANAF_SPV_MAIL_MCP_TOKEN_FILE": "<ANAF_SPV_MAIL_MCP_TOKEN_FILE>",
"ANAF_SPV_MAIL_MCP_COMMAND": "<ANAF_SPV_MAIL_MCP_COMMAND>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ANAF_SPV_USERNAME=<ANAF_SPV_USERNAME> -e ANAF_SPV_PASSWORD_FILE=<ANAF_SPV_PASSWORD_FILE> -e ANAF_SPV_MAIL_MCP_URL=<ANAF_SPV_MAIL_MCP_URL> -e ANAF_SPV_MAIL_MCP_TOKEN_FILE=<ANAF_SPV_MAIL_MCP_TOKEN_FILE> -e ANAF_SPV_MAIL_MCP_COMMAND=<ANAF_SPV_MAIL_MCP_COMMAND> anaf-spv npx -y @foreverworks/mcp-anaf-spvReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ANAF SPV
How do I install ANAF SPV in Claude Code?
Run claude mcp add anaf-spv -- npx -y @foreverworks/mcp-anaf-spv. The server requires Node 22.19 or newer.
What does ANAF SPV do?
It retrieves SPV messages and documents, requests files from ANAF, validates declarations, and files D212. The client requests confirmation before filing.
What does ANAF SPV need to run?
It needs Node 22.19 or newer and an individual SPV account that signs in with a username and password. Store the password in a file or vault MCP server; a mail MCP server retrieves sign-in codes automatically, or someone can enter each code. Declaration validation also requires Java 8 or newer.