PartnerBoost MCP 提供与后台工作流对齐的工具，名称统一为 pb_ 前缀。
一个连接能拿到什么，由商家和 AI Access Key 共同决定：
- 查询工具 — 普通商家 24 把；Walmart 或 Amazon 商家 25 把。
- 操作工具 — 最多 13 把，仅在 Key 持有对应授权范围时下发。Amazon 促销相关工具仅对 Amazon 商家显示。
存量接入的 URL 与 Key 不用重配。重新连接（或开关一次 connector）后，tools/list 即为新清单。
查询工具
账户与看板
| 工具 | 说明 |
|---|
pb_get_merchant_context | 账户、套餐、当前用户、用量一次返回 |
pb_get_dashboard_todo | Dashboard 待办 |
| 工具 | 说明 |
|---|
pb_get_transaction_list | 分页订单列表（standard / multiplatform） |
pb_get_transaction_stats | 订单汇总（销售额、佣金、笔数） |
| 工具 | 说明 |
|---|
pb_get_performance_stats | 账户级业绩汇总（JSON，不出图） |
pb_get_performance_list | 业绩明细 + 周期 totals |
pb_get_partner_performance | 伙伴维度总览（totals + 前 20） |
pb_get_media_partner_performance | 单个伙伴表现 |
账单与佣金
| 工具 | 说明 |
|---|
pb_get_billing_overview | 已付账单 + 待付预付款 |
pb_get_commission_rules | 佣金计划规则（CPS / Amazon / Walmart） |
合作伙伴与媒体
| 工具 | 说明 |
|---|
pb_list_media_partners | 已有媒体伙伴 |
pb_get_publisher_overview | 媒体 / 红人按状态与分组的数量 |
pb_get_media_detail | 统一详情（参数 uid） |
pb_find_media | 自然语言搜索媒体 / 红人 |
pb_get_invited_partners | 邀请 pipeline |
pb_search_products | 产品库 |
Campaign
| 工具 | 说明 |
|---|
pb_get_campaign_list | Campaign 列表 |
pb_get_campaign_overview | Campaign 概览 |
pb_get_campaign_proposals | Campaign 申请 |
pb_get_campaign_detail | Campaign 详情、内容与履约 |
消息与营销
| 工具 | 说明 |
|---|
pb_get_message_stats | 消息统计 |
pb_get_messages | 站内信与系统通知 |
pb_get_newsletter_overview | Newsletter 全貌 |
pb_get_coupon_tracking_list | 优惠券归因 |
操作工具
操作工具让 AI 助手可以直接在你的账户上执行动作，而不只是查询。请在 AI Center → AI Connect → 管理 AI 密钥 中按 Key 授权。
所有操作工具共用同一套入参：
| 字段 | 必填 | 说明 |
|---|
action | 是 | 要执行的操作。可选值以工具自身的 schema 为准——不要自行编造 list、get 这类值。 |
idempotency_key | 是 | 字符串（建议用 UUID）。同一工具下用同一 key 重放不会重复执行；同一 key 换内容会返回冲突错误。 |
sub_action | 否 | 可选的子操作。传未知值会返回 INVALID_SUB_ACTION。 |
dry_run | 否 | 为 true 时只校验并预览，不落库。 |
payload | 否 | 所选操作的业务字段。建议先用 dry_run 验证。 |
合作伙伴操作
| 工具 | 说明 |
|---|
pb_manage_partner_workspace | 关注 / 取关伙伴，管理邀请模板与伙伴分组 |
pb_decide_partner_relationship | 通过或拒绝伙伴发现关系 |
pb_invite_or_message_partners | 批量邀请或联系伙伴 |
商品与佣金操作
| 工具 | 说明 |
|---|
pb_manage_products | 产品库与 datafeed |
pb_manage_creatives | 创建、修改、删除或批量下线创意素材 |
pb_manage_commission_rules | 创建、更新或排序特殊佣金规则 |
pb_manage_amazon_promos | Amazon 促销码与促销活动（仅 Amazon 商家） |
pb_manage_growth_config | 优惠券追踪与广告预算 |
触达操作
| 工具 | 说明 |
|---|
pb_manage_newsletter_templates | Newsletter 模板与分组 |
pb_send_newsletter | 保存、测试或发送 Newsletter |
pb_manage_recruitment_ppc | 招募设置与 PPC |
订单操作
| 工具 | 说明 |
|---|
pb_create_manual_order | 创建手工联盟订单 |
pb_solve_order_inquiry | 处理订单查询 |
- 查询工具需要 Key 持有 全部只读（Read All）授权，所有 Key 默认包含。
- 操作工具还需匹配对应的操作授权，AI Center 界面显示为「合作伙伴写入」「目录写入」「触达写入」「订单写入」。只有已授权的范围才会出现在该 Key 的
tools/list 中。
- 主账号创建的 Key 拥有账号的全部权限；子账号创建的 Key 只拥有该子账号被授予的权限。
- 部分操作还需要商家账号本身具备相应后台权限——例如删除创意素材需要 Admin 的 creative-delete 权限。这类调用即使工具已列出，也会返回
Permission Not Found。
- 每次操作调用都会留痕，包括被拒绝的调用。
平台专属
仅对应平台商家可见：
| 工具 | 可见条件 |
|---|
pb_get_walmart_wsr | Walmart 商家 |
pb_get_amazon_acc_overview | Amazon 商家 |
- 本次更新后请重新连接 MCP 客户端。工具名以
pb_ 开头，与旧名不兼容。服务器 URL 和 AI Access Key 不变。
- 搜索媒体 / 红人可能需要数十秒到几分钟。请等待结果，不要重复追问。
- 已归档的 Key 不能用于 MCP 调用。
若你自行调用工具（需要字段级 ID 或日期格式），见 MCP 常见问题。
示例提问
- 「对比上个月和上上个月的订单汇总。」
- 「佣金最高的 5 个 publisher 是谁？」
- 「搜索美妆类媒体。」
- 「我当前的套餐和用量是什么？」
- 「汇总已付和待付账单。」
- 「为这个 publisher 预览一条佣金规则，确认没问题再创建。」
- 「给我的前 20 个伙伴起草一封 Newsletter，发送前先给我看预览。」