Quaderno MCP Server

Quaderno MCP Server

Connect any AI assistant to Quaderno's tax compliance engine via the Model Context Protocol.

Calculate taxes. Validate tax IDs. Create invoices. All from natural language.

______________________________________________________________________

问题

跨境税务合规是一场噩梦。每个国家不同的增值税税率，根据政府数据库进行税务ID验证，反向收费规则，数字服务税。..你的人工智能助手无法提供帮助，因为它无法访问实时税务数据。

解决方案

此MCP服务器允许任何AI助手（Claude、GPT等）直接访问Quaderno的税务引擎。用简单的英语提问，得到准确、合规的答案。

You: "What tax should I charge for a SaaS sale to a customer in Spain?"
AI:  IVA at 21% — status: taxable, currency: EUR

工具

快速开始

1.获取API密钥

注册地址： 笔记本.io 或创建一个免费 沙盒帐户 用于测试。在中查找您的API密钥 设置>API密钥.

2.配置克劳德桌面

添加到您的配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quaderno": {
      "command": "node",
      "args": ["/path/to/quaderno-mcp-server/dist/index.js"],
      "env": {
        "QUADERNO_API_KEY": "sk_live_your_key_here",
        "QUADERNO_API_URL": "https://your-account.quadernoapp.com/api"
      }
    }
  }
}

对于沙盒测试，请使用 https://your-account.sandbox-quadernoapp.com/api

例子

税费计算

“在西班牙销售数字服务的增值税税率是多少？”

{
  "country": "ES",
  "name": "IVA",
  "rate": 21.0,
  "tax_code": "eservice",
  "status": "taxable",
  "currency": "EUR"
}

税务ID验证

“此西班牙税号有效吗？ESB86412491”

{
  "valid": true
}

完整的发票流程

“为马德里的TechCorp创建一个公司联系人，并向他们开具500欧元的咨询发票”

AI将链 create_contact → create_invoice 自动生成符合税务要求的发票，并应用正确的西班牙IVA。

支持的税务管辖区

Quaderno支架 实时税务计算 适用于200多个国家和以下国家的税务ID验证：

• 欧盟：所有27个成员国（增值税通过VIES）
• 英国：通过英国税务海关总署缴纳增值税
• 瑞士：UID
• 澳大利亚：ABN/GST
• 新西兰：GST
• 加拿大：魁北克QST

发展

git clone https://github.com/AnderRahe/quaderno-mcp-server.git
cd quaderno-mcp-server
npm install
cp .env.example .env   # Add your credentials
npm run build

使用MCP检查员进行测试

npx @modelcontextprotocol/inspector node ./dist/index.js

环境变量

构建于

• 模型上下文协议SDK --服务器框架
• API 文件 --税务合规引擎
• 黄道带 --架构验证
• TypeScript+stdio传输

许可证

麻省理工学院