Giltiq MCP Server
# @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
```bash
npx @giltiq/mcp
```
## Configure
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"giltiq": {
"command": "npx",
"args": ["-y", "@giltiq/mcp"],
"env": {
"GILTIQ_API_KEY": "gq_live_your_key_here"
}
}
}
}
```
### Cursor
Add to `.cursor/mcp.json`:
```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`:
```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](https://giltiq.de). |
| `GILTIQ_API_URL` | No | Override the API base URL (default: `https://api.giltiq.de`). |
## Links
- [API Documentation](https://giltiq.de/en/api-reference/overview/)
- [agents.json](https://giltiq.de/.well-known/agents.json)
- [llms.txt](https://giltiq.de/llms.txt)
- [OpenAPI Spec](https://giltiq.de/openapi.json)
## License
MIT
---
Powered by [Giltiq](https://giltiq.de) — the only VAT validation API with legally binding German tax compliance.
TDQS
Scored across 2 tools
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.
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.
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.
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.