Koskamo

Codice Fiscale Subito MCP

An official MCP server that allows AI assistants to compute, decode, verify, and lookup Italian fiscal codes and historical municipal data via HTTP transport without authentication.

Visit Codice Fiscale Subito

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Codice Fiscale Subito MCP logo, by Codice Fiscale SubitoVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Codice Fiscale Subito
MCP endpoint (Streamable HTTP)
https://codicefiscalesubito.it/api/mcp
Vendor documentation

What you can do with it

  • Compute Italian fiscal code from personal details
  • Decode fiscal code to extract birth data
  • Verify fiscal code format and checksum
  • Lookup historical municipal codes

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: it.codicefiscalesubito/codice-fiscale@1.0.0Project website

Protocol and capabilities

Server
codicefiscalesubito 1.0.0
MCP protocol
2025-06-18
Tools
4 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Free API and MCP server for the Italian codice fiscale: compute it from personal data, decode it (inverso), verify it, and look up the codice catastale of any comune or foreign state valid on a given date (ANPR history, suppressed comuni included). No key, CORS open, messages in Italian. Every tool is read-only and deterministic. Human documentation: https://codicefiscalesubito.it/api-codice-fiscale/

Tools

4 advertised

compute_codice_fiscale — Compute a codice fiscale
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute the Italian codice fiscale (tax code) of a person from surname, name, sex, birth date and birth place, with the D.M. 23/12/1976 rules. The place can be a comune ('Roma', 'Castro (LE)'), a foreign state ('Francia') or a codice catastale ('H501'); the code valid on the birth date is used. Returns the 16 characters and why each group has its value. The Agenzia delle Entrate may assign an omocodic variant: only it confirms a code.

compute_codice_fiscale input schema
{
  "type": "object",
  "required": [
    "surname",
    "name",
    "sex",
    "birth_date",
    "birth_place"
  ],
  "properties": {
    "sex": {
      "enum": [
        "M",
        "F"
      ],
      "type": "string",
      "example": "M",
      "description": "M or F."
    },
    "name": {
      "type": "string",
      "example": "Mario",
      "description": "Given name(s) (nome), all of them."
    },
    "surname": {
      "type": "string",
      "example": "Rossi",
      "description": "Surname (cognome), as on the document."
    },
    "birth_date": {
      "type": "string",
      "example": "1985-12-10",
      "description": "Birth date, YYYY-MM-DD (DD/MM/YYYY accepted)."
    },
    "birth_place": {
      "type": "string",
      "example": "Roma",
      "description": "Comune (with province if ambiguous), foreign state, or codice catastale / Z-code."
    }
  },
  "additionalProperties": false
}
compute_codice_fiscale annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
decode_codice_fiscale — Decode a codice fiscale (inverso)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read back a codice fiscale: sex, birth date (one or two possible centuries), birth comune or foreign state valid on that date, the consonant codes of surname and name, and omocodia. The full name cannot be recovered from a code. Fails with the reason when the format or the check character is wrong.

decode_codice_fiscale input schema
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "example": "RSSMRA85T10H501O",
      "description": "Codice fiscale, 16 characters (spaces and lowercase accepted)."
    }
  },
  "additionalProperties": false
}
decode_codice_fiscale annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
verify_codice_fiscale — Verify a codice fiscale
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check that a codice fiscale is well formed, layer by layer: format, check character, a real birth date, a place code valid on that date, and optionally the surname and name letters. It says whether the code is written correctly, not whether the Agenzia delle Entrate has assigned it (only its own service does).

verify_codice_fiscale input schema
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "example": "RSSMRA85T10H501O",
      "description": "Codice fiscale, 16 characters (spaces and lowercase accepted)."
    },
    "name": {
      "type": "string",
      "example": "Mario",
      "description": "Optional name to match against characters 4-6."
    },
    "surname": {
      "type": "string",
      "example": "Rossi",
      "description": "Optional surname to match against characters 1-3."
    }
  },
  "additionalProperties": false
}
verify_codice_fiscale annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
lookup_place — Find the codice catastale of a place
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search the 15,000 comuni of every era and the foreign states of the ANPR archive by name or by code (codice catastale like H501, Z-code like Z110). Returns up to 20 places with their province and the dates their code was valid. Give a date to keep only the places valid on it.

lookup_place input schema
{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "example": "Pola",
      "description": "Name ('Roma', 'Sant Angelo') or code ('H501', 'Z110')."
    },
    "date": {
      "type": "string",
      "example": "1940-06-02",
      "description": "Optional date YYYY-MM-DD: only places valid on that day."
    }
  },
  "additionalProperties": false
}
lookup_place annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
311 ms
95th percentile latency
311 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 311 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http codice-fiscale-subito-mcp https://codicefiscalesubito.it/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add codice-fiscale-subito-mcp --url https://codicefiscalesubito.it/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable codice-fiscale-subito-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "codice-fiscale-subito-mcp": {
      "url": "https://codicefiscalesubito.it/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "codice-fiscale-subito-mcp": {
      "type": "streamableHttp",
      "url": "https://codicefiscalesubito.it/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start codice-fiscale-subito-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "codice-fiscale-subito-mcp": {
      "type": "http",
      "url": "https://codicefiscalesubito.it/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http codice-fiscale-subito-mcp https://codicefiscalesubito.it/api/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "codice-fiscale-subito-mcp": {
      "url": "https://codicefiscalesubito.it/api/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "codice-fiscale-subito-mcp": {
      "serverUrl": "https://codicefiscalesubito.it/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Codice Fiscale Subito MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 3,947

Do you run Codice Fiscale Subito MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing