inflow-mcpofficial
A
licenseNot graded
qualityD
maintenanceMCP Server for agents to onboard, pay, and provision services autonomously with InFlow
6
MIT
zhizhuip-mcp
OfficialThis server lets an AI assistant query and manage a 蜘蛛IP proxy account, including products, pricing, subaccounts, purchases, renewals, bandwidth, and account details.
Query account balance, account info, custom/official pricing, coupons, and product country/city/state/bandwidth options.
List subaccounts, get credentials/country/expiry, view traffic usage/trends, bandwidth details, IP ranges, whitelist, and provider lists.
Buy dynamic residential traffic, static/datacenter test IPs, static/datacenter time-based IPs, and IPv6 time-based IPs.
Renew static/datacenter and IPv6 time-based IPs, and upgrade subaccount bandwidth.
Create/delete dynamic subaccounts; batch delete, update remarks/IP switch intervals, set custom credentials/passwords, set traffic limits, and toggle IP-port access.
Apply for static residential subaccount refunds and submit IP bookings when inventory is unavailable.
Use confirmation tokens for purchase/destructive actions to request user approval first.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@zhizhuip-mcp查一下我的子账号列表和当前余额"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
zhizhuip-agent-tools
让 Claude Code、Cursor、Codex 等 AI 助手帮你查询蜘蛛 IP 账号、选购代理、生成连接配置和管理子账号。一次安装，同时配置 Skill 与 MCP。
一次安装 Skill 与 MCP
1. 准备环境和 API Key
安装 Node.js 20 或更新版本和 Git，确保终端能运行
node、npx、git，并能访问 GitHub、npm 和蜘蛛 IP 服务。登录蜘蛛 IP 官网，从头像菜单进入 API Keys，创建并复制 API Key。它是安装必填项，输入到安装终端即可，无需发给 AI。查看获取方法。
2. 运行安装命令
以下两种方式任选一种。
方式 1：一键安装
在 PowerShell、终端或 Git Bash 中执行：
npx -y github:Lianzhou-Information-Technology-Co-Ltd/zhizhuip-agent-tools install命令会自动下载项目、安装依赖并构建，无需提前下载源码或运行 npm ci。首次下载请耐心等待。
方式 2：Git 下载到本地安装
在准备存放项目的目录打开终端，依次执行：
git clone https://github.com/Lianzhou-Information-Technology-Co-Ltd/zhizhuip-agent-tools.git
cd zhizhuip-agent-tools
npm ci
node dist/src/index.js installgit clone 下载项目，cd 进入项目目录，npm ci 安装依赖并自动构建，最后一条命令启动安装器。已有源码时，进入项目目录后执行最后两条命令即可。
完成安装
用方向键移动、空格勾选一个或多个客户端，按回车继续；再用方向键选择“当前用户的所有项目”或“当前项目”，回车确认安装范围。选中 Windsurf 或 Cline 时只提供全局范围。最后粘贴 API Key 并回车；Key 验证通过后才开始安装，手动输错可继续输入，选择或输入时均可用 Ctrl+C 取消。若已设置 ZHIZHUIP_TOKEN，会直接使用该环境变量，验证失败需修改变量后重跑。
3. 重启客户端，开始使用
看到“Skill 和 MCP 配置已安装”后，重启所选客户端。按客户端提示启用 zhizhuip MCP 和 Skill，然后对 AI 说：
使用蜘蛛 IP 查询我的账户余额。
返回实际余额即可确认 MCP 连接。之后可以继续说：
“列出我的蜘蛛 IP 子账号。”
“帮我选一个适合固定出口的产品，先查价格。”
“用我已有的动态住宅账号生成代理连接配置。”
没有显示工具或查询失败时，见连接检查与常见问题。
Related MCP server: Kaminari Click MCP Server
选择客户端与安装选项
只安装到 Codex 时，在安装命令后加 --agents codex。同时安装到 Claude Code、Cursor 和 Codex：
npx -y github:Lianzhou-Information-Technology-Co-Ltd/zhizhuip-agent-tools install --agents claude-code,cursor,codex客户端 |
|
Claude Code |
|
Cursor |
|
Codex |
|
Gemini CLI |
|
OpenCode |
|
经典 Windsurf |
|
Cline（VS Code 扩展） |
|
VS Code Copilot |
|
以下选项适用于两种安装方式，均追加在 install 后：
选项 | 用途 |
| 只启用标为只读的工具。 |
| 仅为当前项目安装；请先进入要使用蜘蛛 IP 的项目目录。 |
| 预览安装位置，不写文件、不验证 Key。 |
| 查看适配客户端及安装范围。 |
| 查看完整参数说明。 |
Windsurf 和 Cline 仅支持用户全局安装。Windsurf 适配经典 .codeium/windsurf 目录；Cline 和 VS Code 适配本机默认用户配置，不覆盖远程开发、其他 Profile 或 Insiders。
使用须知
安装不会购买产品。默认开放查询与管理能力，购买、续费、删除等操作执行前需要确认；费用与产品限制以网站及实际返回结果为准。
API Key 保存在所选客户端的本地配置中。配置和安装备份可能包含 Key，请勿提交到仓库或分享。
更多文档
使用指南：客户端配置、使用示例与更新方法。
Skill 操作指南：产品选择、查询与管理流程。
工具覆盖表：支持的工具、产品范围与使用限制。
许可
MIT。
Available Tools
40 toolsbandwidth_detail有效期内带宽详情ARead-onlyIdempotent
查询子账号剩余有效期内已购带宽的详情。后端缓存 120 秒，不要频繁调用。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| subAccount | Yes | 子账号 id |
bandwidth_package_list带宽套餐列表ARead-onlyIdempotent
查询某静态住宅产品在某国家可选的带宽套餐及价格；下单或升级时把返回的带宽值填到 bandwidth_num。
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | 国家编码。国家用 ISO 3166-1 二字码，如 US | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） |
bandwidth_trend子账号带宽趋势ARead-onlyIdempotent
查询子账号的带宽变化趋势：trend_type=1 取最近的实时数据，trend_type=2 按 startTime、endTime 取历史，跨度不超过 31 天。
| Name | Required | Description | Default |
|---|---|---|---|
| endTime | No | 结束时间戳（秒），trend_type=2 时必填 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| startTime | No | 开始时间戳（秒），trend_type=2 时必填 | |
| subAccount | Yes | 子账号id | |
| trend_type | Yes | 趋势类型：1=实时，2=历史（要传 startTime、endTime） |
city_list城市列表ARead-onlyIdempotent
查询某产品某国家下可选的城市；动态住宅产品还要指定州或省。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限），static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），static-ipv6=静态住宅（IPv6），datacenter=数据中心 | |
| state_id | No | 州或省 id，取 state_list 返回的 id。产品 dynamic-no-expiry、dynamic-monthly 下必填 | |
| country_id | Yes | 国家 id，取 country_list 返回的 id | |
| state_code | No | 州或省编码，取 state_list 返回的编码 | |
| country_code | No | 国家编码，取 country_list 返回的编码。国家用 ISO 3166-1 二字码，如 US |
country_list国家列表ARead-onlyIdempotent
查询某产品可选的国家及编码。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限），static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），static-ipv6=静态住宅（IPv6），datacenter=数据中心 |
coupon_list优惠券列表ARead-onlyIdempotent
查询当前账号可用的优惠券，下单或续费时把返回的 id 填到 conpon_id。这个接口按套餐类型与计费模式筛选，不用 product。
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | 套餐类型：0=动态住宅，1=静态住宅，2=数据中心 | |
| status | Yes | 计费模式：0=按流量（动态住宅），1=按时长（静态住宅与数据中心固定填 1） |
flow_package_list已购流量套餐记录ARead-onlyIdempotent
分页查询动态住宅产品已购买的流量套餐记录。
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | 当前页数 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| pagesize | Yes | 每页显示数量 |
ip_booking预约 IPA
需要的国家或地区没有库存时提交预约，管理员审核后补货；只登记需求，不扣费、不建子账号。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 预约的 IP 数量，1 到 1000 | |
| country | Yes | 预约的国家名称（填国家名，不是编码），如 美国 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），datacenter=数据中心 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
ip_range_statusIP 段库存状态ARead-onlyIdempotent
分页查询某静态住宅产品的 IP 段及库存状态；下单时可把有库存的段填到 ip_str 或 specifyIps。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码，默认 1 | |
| ip_str | No | IP 段前缀，1 到 3 段，如 104 或 104.223 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| pageSize | No | 每页条数，默认 50，最大 100 | |
| city_code | No | 城市名称，取 city_list 返回的名称（名称与编码相同） | |
| country_code | No | 国家编码，取 country_list 返回的编码。国家用 ISO 3166-1 二字码，如 US | |
| exclude_ip_str | No | 要排除的 IP 段前缀，多个以英文逗号分隔 |
main_account_flow主账号流量BRead-onlyIdempotent
查询动态住宅主账号的流量汇总。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） |
main_account_switch_token主账号切换 tokenBRead-onlyIdempotent
获取动态住宅主账号的切换 token，用于 api 子账号切换时的独立 token 验证；后端还没有时会生成一个。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） |
official_price官网价格ARead-onlyIdempotent
查询各产品的官网标价。后端缓存 5 分钟。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
order_bandwidth_upgrade子账号带宽升级ADestructive
会从账户余额扣费。把静态住宅子账号的带宽升级到 bandwidth_num；可选档位和价格用 bandwidth_package_list 查；有已过期的子账号时要先续费再升级。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| sub_accounts | Yes | 要升级的子账号 id 列表，单次最多 200 个 | |
| bandwidth_num | Yes | 升级后的目标带宽，必须大于子账号当前带宽，可选值用 bandwidth_package_list 查 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
order_buy_dynamic购买动态住宅流量ADestructive
会从账户余额扣费。购买动态住宅流量，num 为 GB 数；永久套餐流量不过期，期限套餐要用 bill_timelen 指定有效时长。账号须先完成邮箱或手机验证以及实名验证才能购买。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 需要购买的流量数量。单位：GB。范围：1-300GB之间 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| conpon_id | No | 优惠券 id，用 coupon_list 查 | |
| bill_timelen | No | 流量有效时长，product 为 dynamic-monthly 时必填（后端校验）：1=30天，2=90天，3=180天；dynamic-no-expiry 不要传 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
order_buy_ipv6购买 IPv6 时长 IPADestructive
会从账户余额扣费。购买静态住宅 IPv6 时长 IP 子账号，num 为 IP 数量；IPv6 购买不支持优惠券。账号须先完成邮箱或手机验证以及实名验证才能购买。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 需要购买的子账号数量。范围：1-5000之间 | |
| city | No | 城市名称，取 city_list 返回的名称；不传随机 | |
| agree | Yes | 协议 | |
| ip_str | No | 指定的 IPv6 段 | |
| remark | No | 备注 | |
| country | Yes | 静态住宅国家编码code。静态住宅（IPV6）对应国家列表可获取国家编码。支持的静态住宅国家列表可在静态住宅（IPV6）国家查询。国家用 ISO 3166-1 二字码，如 US | |
| timelen | Yes | 购买时长：0=7天，1=30天，2=90天，3=180天，4=360天 | |
| bandwidth_num | No | 购买时选定的增值带宽 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 | |
| verder_order_id | No | 外部请求订单id。非必填。如果传递，则需要每次生成新订单时，这个verder_order_id一定要唯一。否则返回verder_order_id缓存生成的订单数据。缓存有效期4小时。 | |
| use_random_username | No | 创建时是否使用随机账号和密码。0=不使用，1=使用 |
order_buy_test_ip购买测试 IPADestructive
会从账户余额扣费并占用本月测试额度。购买静态住宅或数据中心的时长测试 IP，每单按账号设定的测试订单金额扣款；本月额度用完或本次数量超过剩余额度会被拒绝。有效期默认 1 天，只用于业务测试。账号须先完成邮箱或手机验证以及实名验证才能购买。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 需要购买的子账号数量。范围：1-100之间 | |
| city | No | 城市名称，取 city_list 返回的名称；不传随机 | |
| agree | Yes | 协议 | |
| ip_str | No | 指定ip段，多个以英文逗号分隔 | |
| country | Yes | 国家编码，用 country_list 查该产品可买的国家。国家用 ISO 3166-1 二字码，如 US | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），datacenter=数据中心 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 | |
| exclude_ip_str | No | 指定排除ip段，多个以英文逗号分隔 | |
| use_random_username | No | 是否使用随机账号密码：0=否，1=是 |
order_buy_time_ip购买时长 IPADestructive
会从账户余额扣费。购买静态住宅或数据中心的时长 IP 子账号，num 为 IP 数量。后端限制：num 1 到 300，数据中心单笔不超过 50 个且不支持 7 天档；5 秒内相同参数的重复请求会被拒。账号须先完成邮箱或手机验证以及实名验证才能购买。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 要购买的 IP 数量，后端放行 1 到 300，数据中心单笔不超过 50 | |
| city | No | 城市名称，取 city_list 返回的名称；不传随机 | |
| agree | Yes | 协议 | |
| ip_str | No | 指定ip段，多个以英文逗号分隔 | |
| remark | No | 订单备注 | |
| country | Yes | 国家编码，用 country_list 查该产品可买的国家。国家用 ISO 3166-1 二字码，如 US | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），datacenter=数据中心 | |
| timelen | Yes | 购买时长：0=7天，1=30天，2=90天，3=180天，4=360天 | |
| conpon_id | No | 优惠券 id，用 coupon_list 查 | |
| specifyIps | No | 指定从哪些 IP 段购买，每项写一个 IP 段前缀和该段要买的数量，各段 count 之和必须等于 num；IP 段用 ip_range_status 查 | |
| use_ip_port | No | IP 端口连接状态：0=关闭，1=开启 | |
| bandwidth_num | No | 购买时选定的增值带宽，可选值和价格用 bandwidth_package_list 查；数据中心没有带宽加购，不要传 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 | |
| exclude_ip_str | No | 指定排除ip段，多个以英文逗号分隔 | |
| verder_order_id | No | 外部请求订单id。非必填。如果传递，则需要每次生成新订单时，这个verder_order_id一定要唯一。否则返回verder_order_id缓存生成的订单数据。缓存有效期4小时。 | |
| use_random_username | No | 是否使用随机账号密码：0=否，1=是 |
order_refund_apply申请退单A
为静态住宅的一个子账号申请退单，提交后由人工审核，不会立即退款。后端限制：只能在下单后 1 天内申请；已续费、有进行中的带宽升级订单、消费记录已开票的子账号不能退；同一子账号重复申请会被拒。
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | 子账号 id | |
| remark | Yes | 退单原因 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
order_renew续费时长 IPADestructive
会从账户余额扣费。续费静态住宅或数据中心的时长 IP 子账号，content 按国家分组，每组写子账号 id 列表、国家、续费时长；一次最多 200 个子账号。
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 续费内容，按国家分组，每组写 ids、country、timelen，可选 renew_with_bandwidth | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），datacenter=数据中心 | |
| conpon_id | No | 优惠券 id，用 coupon_list 查 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
order_renew_ipv6续费 IPv6 时长 IPADestructive
会从账户余额扣费。续费静态住宅 IPv6 时长 IP 子账号，content 按国家分组，每组写子账号 id 列表、国家、续费时长；IPv6 续费不支持优惠券。
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 续费内容，按国家分组，每组写 ids、country、timelen | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
provider_list可用供应商列表ARead-onlyIdempotent
查询动态住宅产品可用的供应商（资源池），返回的 id 可作为新增子账号或查询流量时的 spec。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） |
state_list州/省列表ARead-onlyIdempotent
查询动态住宅产品某国家下可选的州或省。
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| country_id | Yes | 国家 id，取 country_list 返回的 id | |
| country_code | No | 国家编码，取 country_list 返回的编码。国家用 ISO 3166-1 二字码，如 US |
sub_account_add新增动态子账号A
为动态住宅产品新增 num 个子账号，消耗主账号已购流量，不额外扣费。返回新建子账号的账号密码。
| Name | Required | Description | Default |
|---|---|---|---|
| num | Yes | 要新增的子账号数量，1 到 500 | |
| url | No | 业务网址 | |
| city | No | 城市名称，取 city_list 返回的名称（名称与编码是同一个值） | |
| spec | No | 指定一个供应商（资源池）id，取 provider_list 返回的 id，只能传一个 | |
| agree | No | 协议，不传默认 SOCKS5 | |
| state | No | 州或省名称，多个以英文逗号分隔，取 state_list 返回的名称（名称与编码是同一个值） | |
| remark | No | 备注 | |
| country | Yes | 国家编码（ISO 3166-1 二字码），多个以英文逗号分隔，如 US,JP；可选国家用 country_list 查 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 | |
| changeInterval | Yes | IP 切换间隔，单位分钟，5 到 120 | |
| use_random_username | No | 是否使用随机账号密码：0=否，1=是 |
sub_account_delete删除子账号ADestructive
不可恢复。删除动态住宅的一个子账号。
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | 子账号id | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_delete_batch批量删除子账号ADestructive
不可恢复。批量删除动态住宅的多个子账号，ids 为英文逗号连接的子账号 id。
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 子账号id集，以英文逗号连接 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_flow子账号流量ARead-onlyIdempotent
查询动态住宅某个子账号在日期区间内每天的流量，返回的 flow 单位 MB。区间最多 30 天，结束日期不能晚于今天。
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | 子账号id | |
| spec | No | 供应商 id，取 provider_list 返回的 id；不传查全部 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| end_date | Yes | 结束日期，格式 YYYY-MM-DD，不早于开始日期、不晚于今天 | |
| start_date | Yes | 开始日期，格式 YYYY-MM-DD |
sub_account_limit_flow子账号流量上限配置BRead-onlyIdempotent
查询动态住宅某个子账号的流量上限设置与已用量。
| Name | Required | Description | Default |
|---|---|---|---|
| account | Yes | 子账号id | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） |
sub_account_limit_flow_batch批量子账号流量上限配置ARead-onlyIdempotent
分页查询多个动态住宅子账号的流量上限设置。
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 页码，从 1 起，不传默认 1 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| accounts | Yes | 子账号 id 集合，多个以英文逗号连接 | |
| pagesize | No | 每页数量，最大 100，不传默认 100 |
sub_account_list子账号列表ARead-onlyIdempotent
分页查询某产品的子账号，返回子账号 id、账号密码、端口、国家、到期时间等；后面所有按子账号操作的工具都从这里取 id。
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | 子账号 id 集合，多个以英文逗号连接 | |
| page | Yes | 当前页数 | |
| remark | No | 按备注模糊搜索（动态产品用） | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限），static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），static-ipv6=静态住宅（IPv6），datacenter=数据中心 | |
| pagesize | Yes | 每页显示数量。每页最大100条数据 | |
| searchArr | No | 搜索值列表（时长类产品用）：search_type=0 时填自定义账号名，search_type=1 时填出口 IP，search_type=2 时只取第一项作为备注关键字 | |
| countryList | No | 国家编码，多个以英文逗号分隔（动态产品用） | |
| search_type | No | 搜索类型：0=自定义账密，1=子账号 IP，2=备注；搜索值放 searchArr（时长类产品用） | |
| customUsername | No | 按自定义账号搜索（时长类产品用） |
sub_account_set_credentials自定义子账号账密A
为子账号设置自定义用户名和密码，一次可传多个；覆盖 content 里每个子账号的账号与密码。
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 要修改的子账号列表，每项写子账号 id、自定义用户名、自定义密码 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限），static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），static-ipv6=静态住宅（IPv6），datacenter=数据中心 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_set_limit_flow设置子账号流量上限A
设置动态住宅某个子账号在一个周期内的流量上限，达到上限断开连接，下个周期恢复；同一个子账号只允许设置一个周期。
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | Yes | 限制周期：0=每天，1=每周，2=每月，3=每季度，4=每年，5=永久（按累计用量，不清零） | |
| account | Yes | 子账号id | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| limit_flow | Yes | 上限流量，单位 GB，0 到 1000000；传 0 表示删除该子账号的流量限制 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_set_limit_flow_batch批量设置子账号流量上限B
批量设置多个动态住宅子账号在同一周期内各自的流量上限；同一个子账号只允许设置一个周期。
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | Yes | 限制周期：0=每天，1=每周，2=每月，3=每季度，4=每年，5=永久（按累计用量，不清零） | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| accounts | Yes | 子账号配置列表，每项写子账号 id（account）和上限流量 GB（limit_flow） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_set_password_batch批量改子账号密码A
批量修改时长类子账号的密码，只改密码不改用户名；密码只能是字母和数字，长度 8 到 30。前提是子账号已设置过自定义用户名和密码，系统默认的账密不能用它改，要先用 sub_account_set_credentials 设置。
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | 要修改的子账号列表，每项写子账号 id 与新密码 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生），datacenter=数据中心 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_toggle_port批量开关端口连接B
批量开启或关闭静态住宅子账号的 IP 端口连接状态。
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 子账号id集合,多个以英文逗号分隔。单次最多200个 | |
| product | Yes | 产品：static-standard=静态住宅（非原生），static-native=静态住宅（原生），static-isp-native=静态住宅（运营商原生） | |
| use_ip_port | Yes | 开关状态：0=关闭，1=开启 | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_update修改子账号备注B
修改动态住宅某个子账号的备注。
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | 子账号id | |
| remark | No | 备注 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 |
sub_account_update_batch批量修改子账号A
批量修改多个动态住宅子账号的备注或 IP 切换间隔，ids 为英文逗号连接的子账号 id。
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 子账号id集，以英文逗号连接 | |
| remark | No | 备注 | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） | |
| confirm_token | No | 确认码。客户端不支持弹窗确认时，第一次调用只返回操作预览和确认码；把预览告诉用户并得到同意后，用相同参数带上确认码再调一次。支持弹窗确认的客户端不需要这个参数 | |
| changeInterval | No | IP 切换间隔，单位分钟，1 到 120 |
sub_account_whitelist子账号白名单ARead-onlyIdempotent
读取动态住宅某个子账号的 IP 白名单。
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | 子账号 id | |
| product | Yes | 产品：dynamic-no-expiry=动态住宅流量（永久），dynamic-monthly=动态住宅流量（期限） |
user_balance账户余额ARead-onlyIdempotent
查询当前账号余额，data 直接是金额字符串，单位元。充值余额与赠送余额的拆分看 user_info。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
user_info账号信息ARead-onlyIdempotent
查询当前账号的基本信息与余额：money 总余额、origin_money 充值余额、give_money 赠送余额。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
user_price用户价格ARead-onlyIdempotent
查询当前账号各产品的实际价格，含管理员给该账号设置的自定义价；下单前用它估算费用。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
40 tool updates
v0.1.0- First observed
bandwidth_detail - First observed
bandwidth_package_list - First observed
bandwidth_trend - First observed
city_list - First observed
country_list - First observed
coupon_list - First observed
flow_package_list - First observed
ip_booking - First observed
ip_range_status - First observed
main_account_flow - First observed
main_account_switch_token - First observed
official_price - First observed
order_bandwidth_upgrade - First observed
order_buy_dynamic - First observed
order_buy_ipv6 - First observed
order_buy_test_ip - First observed
order_buy_time_ip - First observed
order_refund_apply - First observed
order_renew - First observed
order_renew_ipv6 - First observed
provider_list - First observed
state_list - First observed
sub_account_add - First observed
sub_account_delete - First observed
sub_account_delete_batch - First observed
sub_account_flow - First observed
sub_account_limit_flow - First observed
sub_account_limit_flow_batch - First observed
sub_account_list - First observed
sub_account_set_credentials - First observed
sub_account_set_limit_flow - First observed
sub_account_set_limit_flow_batch - First observed
sub_account_set_password_batch - First observed
sub_account_toggle_port - First observed
sub_account_update - First observed
sub_account_update_batch - First observed
sub_account_whitelist - First observed
user_balance - First observed
user_info - First observed
user_price
TDQS
A3.6/5.0
Scored across 40 tools
Disambiguation5/5
Each tool targets a distinct resource and action—user info, pricing, orders, sub-account lifecycle, and bandwidth—with no overlapping purposes. Even similar tools like sub_account_update vs sub_account_update_batch are clearly separated by single vs batch operation.
Naming Consistency5/5
All tools follow snake_case with consistent verb prefixes (order_, sub_account_, user_, etc.), making the naming predictable and easy to navigate. The pattern is uniform across the entire set.
Tool Count2/5
40 tools is far beyond the typical well-scoped range and feels heavy. Many tools are batch variants or could be consolidated (e.g., sub_account_set_limit_flow and its batch counterpart), and the large surface increases cognitive load for agents.
Completeness4/5
The set covers core proxy operations comprehensively: user info, pricing, orders (buy/renew/upgrade/refund), sub-account management, and bandwidth queries. Minor gaps exist, such as no explicit order history or whitelist update tool, but these are not critical for typical workflows.
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues
Related MCP Connectors
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Sherweb Platform MCP server to manage subscriptions and orders. Use OpenID Connect to authenticate.
Search multi-merchant supply, checkout, and track orders via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables querying traffic-quality statistics, managing reports, and downloading IP/UA risk databases via MCP.14 npmMIT
- AlicenseAqualityBmaintenanceEnables the full Ingram Micro Reseller purchasing lifecycle through a single stateless HTTP MCP service, covering catalog and pricing, quotes, quote-to-order, order placement/modification/cancellation/lookup, invoices, renewals, special deals, returns, and freight estimates with one set of credentials.24Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to access Amazon Selling Partner and Advertising APIs for orders, inventory, pricing, ads, reports, and related read paths.MIT
