Skip to main content
Glama
Giltiq MCP Server

Giltiq MCP Server

by giltiq

@giltiq/mcp

MCP server for EU VAT validation with multi-source reliability (VIES + Germany's BZSt), automatic failover, and legally binding qualified confirmations per §18e UStG. Works when VIES is down. No other MCP server provides this.

Install

npx @giltiq/mcp

Related MCP server: vies-smoother

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "giltiq": {
      "command": "npx",
      "args": ["-y", "@giltiq/mcp"],
      "env": {
        "GILTIQ_API_KEY": "gq_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "giltiq": {
      "command": "npx",
      "args": ["-y", "@giltiq/mcp"],
      "env": {
        "GILTIQ_API_KEY": "gq_live_your_key_here"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "giltiq": {
      "command": "npx",
      "args": ["-y", "@giltiq/mcp"],
      "env": {
        "GILTIQ_API_KEY": "gq_live_your_key_here"
      }
    }
  }
}

No API key? The server works without one in anonymous mode (10 free validations, VIES only). Set GILTIQ_API_KEY to unlock 100 calls/month, qualified confirmations, and usage tracking.

Tools

Tool

Description

validate_vat_id

Validate an EU VAT ID against VIES + BZSt with automatic failover and cached fallback. Returns company data and source freshness.

qualified_confirmation

Request a legally binding BZSt qualified confirmation per §18e UStG for audit-proof cross-border VAT exemption. Returns match results and a receipt_id for audit retrieval.

get_qualified_confirmation

Retrieve a past qualified confirmation receipt by receipt_id. Use for §18e UStG audit evidence.

list_qualified_confirmations

List qualified confirmation receipts you've issued, newest first. Filter by target_vat_id to find past audits of a specific customer.

check_api_status

Check real-time availability and latency of VIES and BZSt upstream sources.

get_usage

Get current API usage: calls used, monthly limit, tier, and reset date.

Environment Variables

Variable

Required

Description

GILTIQ_API_KEY

No

API key for authenticated access. Without it, runs in anonymous mode (10 lifetime calls). Get one free at giltiq.de.

GILTIQ_API_URL

No

Override the API base URL (default: https://api.giltiq.de).

License

MIT


Powered by Giltiq — the only VAT validation API with legally binding German tax compliance.

Available Tools

2 tools
check_api_statusA

Check real-time availability and latency of VIES and BZSt upstream sources. Shows which source is active, whether failover is engaged, and per-source latency in milliseconds.

Inputs: no named parameters.

validate_vat_idA

Validate an EU VAT ID against multiple sources (VIES + Germany's BZSt) with automatic failover and cached fallback. Returns structured company data with parsed address and source freshness indicator. Works when VIES is down.

Inputs: vat_id (required), force_live.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools have clearly distinct purposes: one validates VAT IDs, the other checks upstream API status. There is minor potential overlap in that both relate to the VAT validation domain, but the actions are unambiguous and not confusable.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (validate_vat_id, check_api_status). The naming style is uniform snake_case with descriptive verbs, making the pattern predictable and clear.

    Tool Count2/5

    With only 2 tools, the server feels thin for a VAT validation service. A typical complete server would include additional operations like fetching supported country codes, retrieving detailed validation history, or parsing raw responses, making this surface minimal.

    Completeness2/5

    The server provides core validation and a status-check companion, but lacks obvious supporting operations such as listing supported jurisdictions, retrieving cached/failed validations history, or handling bulk validations. The domain is narrow and mostly covered, but agents cannot perform related common tasks.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      SLA'd EU VAT number validation for AI agents via VIES, with caching and circuit-breaking to handle flaky upstream, returning valid/invalid/unavailable responses.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Validates EU and Northern Ireland VAT numbers against the official VIES service, returning validity, company name and address, and distinguishing invalid from unavailable. Supports bulk checking up to 100 VAT IDs.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Validates EU, UK, and AU VAT numbers against live sources and uses AI pattern analysis to detect invoice fraud.
      52 npm
      MIT