Stuart MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.15.4更新于 Nov 7, 2026

Quote, validate, book and track Stuart courier deliveries; cancel jobs and check zone coverage.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行位置与生活商业与电商

概览

AI 生成的概览

面向 Stuart 快递配送的托管 MCP 服务器:可报价、校验、下单、跟踪和取消配送任务,并查询区域覆盖范围。

可以做什么
  • 下单前报价与校验:价格预估、任务校验、取件与送达 ETA、地址校验
  • 查看任务:列出近期任务的状态、跟踪链接、司机与价格,并查看单个任务详情
  • 下单与管理配送:创建含 1-8 个送达点的任务、修改详情、标记订单就绪、取消整个任务或单个配送
  • 查询覆盖与时段:区域 GeoJSON 范围,以及按区域和日期查询可用时间段
  • 获取进行中配送的匿名司机电话号码
  • 管理服务套餐:用量状态、升级、取消订阅、提交功能请求
适用场景
适合让助手为 Stuart 快递询价并下单、跟进进行中的配送,或判断某地址是否在 Stuart 配送区域内,而无需自行编写 API 代码。
运行要求
通过 streamable HTTP 连接的远程端点,只需填写 URL,登录使用 OAuth。首次连接时需选择生产或沙箱环境,并提供 Stuart 管理后台中的 API client ID 与 client secret;两个环境的凭据相互独立。免费套餐每月 50 次工具调用。
安装前请注意
在生产环境创建任务会真实下单并产生费用,试验请使用沙箱。快递员已在路上时取消可能收取费用;写入类工具会修改 Stuart 数据,执行前应先确认。登录页会要求填写 Stuart API client ID 与 secret。付费套餐通过 Stripe 结账链接付款,取消后当前周期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Stuart MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fstuart/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "stuart-by-usefulapi": {
      "type": "http",
      "url": "https://stuart.usefulapi.io/mcp"
    }
  }
}

README

Stuart MCP by usefulapi

Quote, validate, book and track Stuart courier deliveries; cancel jobs and check zone coverage.

Live endpoint: https://stuart.usefulapi.io/mcp · Homepage: https://usefulapi.io/stuart

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://stuart.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http stuart https://stuart.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "stuart": {      "url": "https://stuart.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Stuart credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/stuart/

On first connect you'll pick the environment (production or sandbox) and paste your Stuart API client ID and API client secret (Stuart admin → API credentials: https://admin.stuart.com for production, https://admin.sandbox.stuart.com for the sandbox; the two environments have separate credentials). Creating a job on production books a real, charged courier: use the sandbox to try things out.

Tools

ToolTypeWhat it does
stuart_list_jobsreadList delivery jobs
stuart_get_jobreadGet a delivery job
stuart_estimate_pricereadGet a delivery price quote
stuart_validate_jobreadValidate a delivery job
stuart_estimate_pickup_etareadEstimate courier arrival at pickup
stuart_estimate_dropoff_etareadEstimate time to dropoff
stuart_validate_addressreadValidate a pickup or dropoff address
stuart_get_zone_coveragereadGet a zone's coverage area
stuart_get_zone_schedule_slotsreadGet a zone's scheduling slots
stuart_get_courier_phonereadGet the courier's anonymous phone number
stuart_create_jobwriteCreate a delivery job (dispatches a courier)
stuart_update_jobwriteUpdate delivery details
stuart_cancel_jobwriteCancel a delivery job
stuart_cancel_deliverywriteCancel one delivery
stuart_mark_order_readywriteSignal that an order is ready for pickup
stuart_usage_statusmetaUsage status (free-tier meter)
stuart_request_featuremetaRequest a missing feature
stuart_upgrademetaUpgrade to Pro or Pro+
stuart_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with stuart_upgrade (it returns a Stripe Checkout link). Cancel any time with stuart_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running stuart_upgrade before then undoes the cancel. Or write to [email protected].

License

来源:servers/stuart/README.md,提交 4046075

工具

15

stuart_list_jobs

List delivery jobs

List the delivery jobs of the last 90 days, newest pickup first, with status, deliveries (tracking URLs, courier proof), driver and pricing. Filter by status, active or your client_reference. Paginated: when a page returns per_page rows, ask for the next page. Stuart: GET /v2/jobs.

输入参数pageactivestatusper_pageclient_reference

stuart_get_job

Get a delivery job

One job in full: status, each delivery with tracking URL, pickup/dropoff addresses and contacts, ETA, cancellation, proof of delivery, driver, distance and pricing. Stuart: GET /v2/jobs/{jobId}.

输入参数job_id必填

stuart_estimate_price

Get a delivery price quote

Price of a job before you create it: amount excluding and including tax, and currency. Nothing is booked. Needs pickup address, dropoff address and package type. Stuart: POST /v2/jobs/pricing.

输入参数pickup必填dropoffs必填pickup_at

stuart_validate_job

Validate a delivery job

Check that a job would be accepted (addresses geocode inside a covered zone, fields valid) without creating it. Returns {valid}. Stuart: POST /v2/jobs/validate.

输入参数pickup必填dropoffs必填pickup_at

stuart_estimate_pickup_eta

Estimate courier arrival at pickup

Estimated seconds until a courier could arrive at the pickup address, for the same job body as create. Nothing is booked. Stuart: POST /v2/jobs/eta.

输入参数pickup必填dropoffs必填pickup_at

stuart_estimate_dropoff_eta

Estimate time to dropoff

Estimated seconds to reach the destination address for a job (coordinates need the text address too). Nothing is booked. Stuart: POST /v2/jobs/cpt.

输入参数pickup必填dropoffs必填pickup_at

stuart_validate_address

Validate a pickup or dropoff address

Check that an address can be geocoded and lies inside a Stuart zone, as a pickup (picking) or a dropoff (delivering). A phone number is needed when the address is approximate. Stuart: POST /v2/addresses/validate.

输入参数type必填phoneaddress必填coordinates

stuart_get_zone_coverage

Get a zone's coverage area

GeoJSON of the picking or delivery area of an open Stuart zone (for example paris, london). Stuart: GET /v2/areas/{zone}.

输入参数type必填zone必填

stuart_get_zone_schedule_slots

Get a zone's scheduling slots

Available time slots (start and end, 15-minute steps) in a zone for a date, from the time of the request onward. Use a future date. Stuart: GET /v2/jobs/schedules/{zone}/{type}/{date}.

输入参数date必填type必填zone必填

stuart_get_courier_phone

Get the courier's anonymous phone number

Anonymised phone number of the courier assigned to a delivery. Only works once a courier is assigned; expires when the delivery ends. Stuart: GET /v2/deliveries/{deliveryId}/phone_number.

输入参数delivery_id必填

stuart_create_job

Create a delivery job (dispatches a courier)

BOOKS A REAL, CHARGED DELIVERY: creates a job with one pickup and 1-8 dropoffs and starts looking for a courier right away (unless pickup_at schedules it: up to 4 days ahead, 30 for corporate accounts). Get a quote with stuart_estimate_price and check with stuart_validate_job first, and confirm with the user. Use the sandbox environment for tests. Stuart: POST /v2/jobs.

输入参数pickup必填dropoffs必填pickup_atassignment_code

stuart_update_job

Update delivery details

Change allowed details of a delivery in a job: client_reference, package_description, and the pickup/dropoff comment and contact (what is editable depends on the delivery status: once delivered only client_reference). Stuart: PATCH /v2/jobs/{jobId}.

输入参数job_id必填pickupdropoffdelivery_id必填client_referencepackage_description

stuart_cancel_job

Cancel a delivery job

Cancels a whole job and all its deliveries. Stuart may charge a cancellation fee once a courier is on the way; confirm with the user first. Give a reason key for reporting. Stuart: POST /v2/jobs/{jobId}/cancel.

输入参数job_id必填commentpublic_reason_key

stuart_cancel_delivery

Cancel one delivery

Cancels a single delivery (one dropoff) of a multi-drop job. A cancellation fee may apply; confirm with the user first. Stuart: POST /v2/deliveries/{deliveryId}/cancel.

输入参数commentdelivery_id必填public_reason_key

stuart_mark_order_ready

Signal that an order is ready for pickup

Tell Stuart the order is packed and ready for the courier to collect. Pass exactly one of job_id (all orders of the job) or delivery_id (one order). Send it only when the order is really ready. Stuart: POST /v2/jobs/{jobId}/order_ready or /v2/deliveries/{deliveryId}/order_ready.

输入参数job_iddelivery_idorder_ready_at

版本历史

14
  1. v1.15.4最新Nov 7, 2026
  2. v1.14.3Nov 5, 2026
  3. v1.14.2Nov 5, 2026
  4. v1.14.1Nov 4, 2026
  5. v1.14.0Nov 3, 2026
  6. v1.13.1Nov 3, 2026
  7. v1.12.0Nov 1, 2026
  8. v1.10.0Oct 31, 2026
  9. v1.9.0Oct 31, 2026
  10. v1.8.2Oct 30, 2026
  11. v1.8.0Oct 30, 2026
  12. v1.3.0Oct 26, 2026
  13. v1.0.3Oct 25, 2026
  14. v1.0.0Oct 25, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成