增值税验证服务

用于欧盟增值税验证的多源可靠性服务器,提供自动故障转移和法律约束的合格确认。

  • by giltiq
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 giltiq/giltiq-mcp

使用说明

@giltiq/mcp

用于欧盟增值税验证的MCP服务器 多源可靠性 (VIES+德国BZSt),自动故障转移,具有法律约束力 符合UStG第18e条规定的合格确认书。VIES关闭时工作。没有其他MCP服务器提供此功能。

安装

npx @giltiq/mcp

配置

克劳德桌面版

添加 ~/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/mcp.json:

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

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

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

没有API密钥? 服务器在匿名模式下工作(10次免费验证,仅VIES)。集 GILTIQ_API_KEY 解锁每月100次通话、合格确认和使用情况跟踪。

工具

工具 说明
validate_vat_id 通过自动故障转移和缓存回退,根据VIES+BZSt验证欧盟增值税ID。返回公司数据和来源新鲜度。
qualified_confirmation 根据美国税法第18e条,请求具有法律约束力的BZSt合格确认书,以获得跨境增值税豁免的审计证明。返回匹配结果和 receipt_id 用于审计检索。
get_qualified_confirmation 通过以下方式检索过去的合格确认回执 receipt_id用于§18e UStG审计证据。
list_qualified_confirmations 列出您签发的合格确认收据,最新的先到。筛选依据 target_vat_id 查找特定客户的过去审计。
check_api_status 检查VIES和BZSt上游源的实时可用性和延迟。
get_usage 获取当前API使用情况:使用的调用、每月限制、级别和重置日期。

环境变量

变量 必填 描述
GILTIQ_API_KEY 没有用于身份验证访问的 neneneba API密钥。如果没有它,则以匿名模式运行(10次终身调用)。免费获得一个 吉尔蒂克.
GILTIQ_API_URL 否 覆盖API基础URL(默认值: https://api.giltiq.de).

链接

许可证

麻省理工学院


由...驱动 吉尔提克 -唯一具有法律约束力的德国税务合规性的增值税验证API。