Avalara Developer Documentation

Avalara

这是一个非社区仓库，由 Avalara 创建并维护

---

Avalara MCP 服务

MCP（Model Context Protocol） 服务以标准化的方式，将 AI 应用与 Avalara 的税务合规系统连接起来。MCP 服务允许合作伙伴和开发者集成 AI 驱动的税务工作流、自动处理跨境合规，并访问 Avalara 定期更新的税务内容。

Avalara 支持的 MCP 服务包括 AvaTax、Returns、E-Invoicing and Live Reporting、Tax Registrations and Business Licenses and Exemption Certificate Management、Cross Border Trade 和 Tax Content。未来还将逐步添加更多服务。

你可以：

1. 查询实时税率和税额计算
2. 访问合规监控和法规更新
3. 管理免税证明、营业执照和申报表
4. 获取文档和指南

开始使用 Avalara MCP 服务

了解如何设置 Avalara Model Context Protocol（MCP）服务并连接，以集成 AI 驱动的税务合规功能。

前提条件

要连接到 Avalara MCP 服务，你需要：

• Avalara 订阅：你必须拥有有效的 Avalara 账户
• AI 客户端：使用 FastMCP 或其他兼容 MCP 的库构建的编程客户端。
• 现代 Web 浏览器：OAuth 2.1 授权流程所必需。

如何连接：

步骤 1：设置 MCP 客户端 按照各个 MCP 服务页面提供的步骤操作。

步骤 2：授权访问

• 出现提示时，你的 MCP 客户端 会将你重定向到 Avalara 的安全登录页面
• 使用 Avalara 凭据登录
• 查看权限：确认客户端为访问特定 MCP 服务功能所请求的权限
• 授予许可以完成 OAuth 流程

可用的 MCP 服务

服务	描述	安装
Avalara AvaTax MCP 服务	提供对 Avalara AvaTax API 的访问，用于税费计算、交易管理、税务关联处理和合规数据查询。
Avalara Returns MCP 服务	提供对 Avalara Global Returns API 的访问，用于纳税申报管理、申报日历和合规数据查询。
Avalara 税务注册与营业执照 MCP 服务	提供对 Avalara Tax Registration 和 Business Licenses API 的访问，用于执照指导、销售税和工资税注册、问卷管理以及业务活动验证。
Avalara 电子发票与实时报告 MCP 服务	提供对 Avalara E-Invoicing 和 Live Reporting API 的访问，用于查询文档状态、下载合规文档以及管理各司法管辖区的合规事务。
Avalara 免税证明管理 MCP 服务	提供对 Avalara Exemption Certificate Management API 的访问，用于管理证明、客户资料和公司数据。
Avalara 跨境贸易服务 MCP 服务	跨境贸易服务 MCP 服务通过提供跨境交易工具（包括关税计算）以及贸易和关税内容库（包括进口贸易限制）的访问，支持 AI Agent。
Avalara 税务内容 MCP 服务	提供对 Avalara Tax Content（ATC）数据的访问，包括住宿和汽车租赁相关的 Transaction Tax Export（TTE）配置、作业、通信和用户定义函数。
Avalara 开发者文档 MCP 服务	提供对 Avalara 开发者文档和集成指南的访问，包括技术文档、产品信息、操作指南和代码示例。
Avalara 商品归类 MCP 服务	为跨境交易提供协调制度（HS）编码归类。支持托管式归类请求、HS 编码验证与核验、AI 驱动的进出口查询，以及丰富的贸易合规内容查询。

常见问题排查：

• 连接失败：请确认 Avalara 账户状态和网络连接正常。
• 权限被拒绝：请确保账户有权访问所请求的服务。
• HTTP 429（请求过多）：您已超出服务端的速率限制。
• 重试前请等待几分钟。
• 请在服务器的详情页查看其速率限制信息。