使用说明

代理云优惠券MCP服务

这是一种基于MCP协议的优惠券服务，提供查询、过滤和生成多类优惠券的促销链接的功能，支持外卖、餐饮、休闲娱乐、酒店和民宿、门票和度假以及药品。

特性

支持查询6种主要类型的优惠券：
- 取出产品优惠券
- 餐饮优惠券
- 休闲娱乐优惠券
- 酒店和寄宿家庭优惠券
- 门票和度假券
- 药品优惠券
为优惠券提供完整的生命周期管理：
- 优惠券列表查询
- 促销链接生成（支持多种链接类型）

工具详细信息

优惠券列表查询

list_takeaway_coupons -外卖产品优惠券列表
list_restaurant_coupons -餐饮优惠券列表
list_entertainment_coupons -休闲娱乐优惠券列表
list_hotel_coupons -酒店和寄宿家庭优惠券列表
list_travel_coupons -门票和度假券清单
list_medical_coupons -药品优惠券列表

促销链接生成

get_takeaway_promotion_link -外卖产品优惠券促销链接
get_restaurant_promotion_link -餐饮优惠券促销链接
get_entertainment_promotion_link -休闲娱乐优惠券促销链接
get_hotel_promotion_link -酒店和寄宿家庭优惠券促销链接
get_travel_promotion_link -门票和度假券促销链接
get_medical_promotion_link -药品优惠券促销链接

详细工具说明

优惠券列表查询工具

[list_takeawayy_coupons]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L130-L180）

检索外卖产品优惠券列表

函数：根据指定条件查询外卖券类别信息，支持搜索和分页
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫可选）
- size：每页项目数，默认值为10
- current：当前页码，默认为1
- longitude：经度（必填）
- latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

[list_restaurant_coupons]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L233-L280）

检索餐饮优惠券列表

函数：查询餐券信息，支持搜索和分页
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫可选）
- size：每页项目数，默认值为10
- current：当前页码，默认为1
- longitude：经度（必填）
- latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

[list_entertainment_coupons]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L335-L382）

检索休闲娱乐优惠券列表

函数：查询休闲娱乐优惠券信息
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫可选）
- size：每页项目数，默认值为10
- current：当前页码，默认为1
- longitude：经度（必填）
- latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

[list_hotel_ops]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L434-L481）

检索酒店和寄宿家庭优惠券列表

函数：查询酒店和民宿优惠券信息
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫可选）
- size：每页项目数，默认值为10
- current：当前页码，默认为1
- longitude：经度（必填）
- latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

[list_travel_coopons]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L533-L580）

检索机票和度假优惠券列表

函数：查询机票和度假券信息
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫可选）
- size：每页项目数，默认值为10- current：当前页码，默认为1
longitude：经度（必填）
latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

[list_medical_coupons]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L632-L679）

获取医疗优惠券列表

函数：查询医疗券信息
参数:
- search_text：搜索关键字（优惠券名称、店铺名称）
- search_id：寻呼ID（第一次呼叫不需要）
- size：每页项目数，默认值为10
- current：当前页码，默认为1
- longitude：经度（必填）
- latitude：纬度（必填）
返回值：包含优惠券数据或错误消息的词典

促销链接生成工具

[get_takeaway_provement_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L184-L229）

为外卖优惠券生成促销链接

函数：根据指定条件生成外卖优惠券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

[get_restaurant_promotion_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L284-L331）

为餐厅优惠券生成促销链接

函数：根据指定条件生成餐厅优惠券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

[get_intertainment_promotion_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L386-L430）

为休闲娱乐优惠券生成促销链接

函数：根据指定条件生成休闲娱乐优惠券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

[get_hotel_provement_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L485-L529）

为酒店和寄宿家庭优惠券生成促销链接

函数：根据指定条件生成酒店和寄宿家庭优惠券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

[get_travel_promotion_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L584-L628）

为门票和度假券生成促销链接

函数：根据指定条件生成门票和度假券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

[get_medical_promotion_link]（文件：//D:\pyProject\agentsyun_coupon_mcp_server\agentsyun _coupon_mcp_server \server.py#L683-L728）

生成医疗优惠券的促销链接

函数：根据指定条件生成医疗优惠券的促销链接
参数:
- link_type：链接类型（1:H5长链接；2:H5短链接；3:深度链接；4:微信小程序路径；5:组命令；6:小程序代码），默认为2
- sku_id：优惠券的SKU ID（必填）
返回值：包含促销链接数据或错误消息的词典

首选 Agentsyun开放平台得到你的 your_app_key 和 your_app_secret

环境要求

Python>=3.12
环境变量配置：
- [APP_KEY]（文件：//D:\pyProject\huizhi_coupon_mcp_server\agentsyun_coupon_mcp_servers\server.py#L33-L33）：应用程序密钥（对应于APP ID）-[APP_SECRET]（文件://D:\py Project\huiji_cupon_mcp_server\agentsyun_coupon_mcp.server.py#L34-L34）：应用机密（对应于APP SECRET）

快速开始

1.获取身份验证信息

转到 Agentsyun开放平台获取您的APP_KEY（APP ID）和APP_SECRET（APP机密）。

对于stdio部署：

只需通过环境变量注入即可。 JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：[ “agentsyun优惠券mcp服务器” ], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }
对于Volcano Engine的远程方法：

从火山引擎MCP介绍页面获取以下JSON文件。令牌生成规则：base64（APP_KEY-APP_SECRET）例如，如果APP_KEY为123456，APP_SECRET为abcdef，则实际生成的令牌将是123456 abcdef的base64编码（MTIzNDU2LWFiY2RlZg==）。 JSON { “mcpServers”：{ “agentsyun_mcp”：{ “url”：“https://sd40suov6n5j6uua1fiig.apigateway-cn-beijing.volceapi.com/mcp", “标题”：{ “授权”：“承载your_token” } } } }

注意：令牌中的APP_KEY和APP_SECRET将覆盖本地的APP_KEY和APP_SECRET。开放平台地址：https://mcp.agentsyun.com

有关更详细的开发文档：https://agentsyun.feishu.cn/wiki/ZDlfwN37PiRqgbknMwYc3kO6nqd

2.开发者福利

开发人员可以从优惠券客户交易中获得佣金。
支持美团频道优惠券。
支持MCP渠道促销链接生成。

3.选择传输方式

从以下三种传输方式中选择一种：

标准（默认）：本地调用
SSE：远程服务调用
可流式传输http：远程服务调用

4.标准调用方法

首先，您需要在本地安装Python uv管理工具。安装文件：https://hellowac.github.io/uv-zh-cn/getting-started/installation/

标准传输的本地配置

只需在本地客户端中添加以下配置：

JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：[ “agentsyun优惠券mcp服务器” ], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }

使用阿里云源作为替代方案

如果上述代码未能成功拉取，则可能是由于网络问题。您可以使用阿里云源代码：

JSON { “mcpServers”：{ “代理商优惠券”：{ “命令”：“uvx”， “args”：[ “--索引url”， "https://mirrors.aliyun.com/pypi/simple/", “agentsyun优惠券mcp服务器” ], “env”：{ “APP_KEY”：“您的APP_KEY来自开放平台”， “APP_SECRET”：“来自开放平台的APP_SECRET” } } } }

SSE/流式执行，本地克隆代码，配置环境变量，并按如下方式执行：

1.SSE传输（需要在本地拉动包装）

SSE传输支持实时数据推送，适用于远程部署MCP服务器。

使用SSE在本地运行服务： bash 导出APP_KEY=您的应用密钥导出APP_SECRET=您的应用密码 agentsyun优惠券mcp服务器sse

命令设置APP_KEY=您的应用密钥设置APP_SECRET=您的应用程序密码 agentsyun优惠券mcp服务器sse

PowerShell $env:APP_KEY=“您的应用密钥” $env:APP_SECRET=“您的应用程序密钥” agentsyun优惠券mcp服务器sse

MCP客户端配置：

根据实际服务器地址进行配置。

2.流式HTTP传输（需要在本地拉取包）

使用Streamable HTTP在本地运行服务： bash 导出APP_KEY=您的应用密钥导出APP_SECRET=您的应用密码 agentsyun优惠券mcp服务器可流式传输http