FinerWorks MCP by usefulapi

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

Read FinerWorks orders, inventory, catalog, prices and shipping quotes; never submits an order.

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

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

只读访问 FinerWorks 印刷账户:订单、生产状态、虚拟库存、产品目录、价格与运费报价。

可以做什么
  • 查询订单:列出、筛选并获取完整订单详情、生产状态与状态定义,以及待处理订单
  • 查看虚拟库存与产品详情,并按 SKU 或产品代码获取价格明细
  • 浏览目录:产品类型、介质、印刷样式、静态产品、相框系列与相框、卡纸和玻璃/亚克力
  • 为拟下单的订单获取运费选项与费率,并校验收件地址
  • 查看账户信息与用量、提交功能需求,并管理订阅方案
适用场景
适合管理 FinerWorks 印刷账户的人,让助手在不打开后台的情况下查询订单状态、已保存库存、目录选项、价格或运费估算。
运行要求
远程托管端点,无需本地安装。通过 OAuth 登录,登录页要求填写 FinerWorks 的 web_api_key 和 app_key。客户端配置中只添加服务器 URL,不要添加 Authorization 头或 API 密钥。免费方案每月 50 次工具调用,付费方案可提高上限。
安装前请注意
该服务器只读取和报价,不会提交、修改或删除订单。订阅类工具可通过 Stripe Checkout 链接开通付费方案并取消 Pro,当前周期不退款。FinerWorks 凭据需在托管登录页输入,账户与订单数据会经过第三方托管方。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

FinerWorks MCP by usefulapi

Use FinerWorks from Claude, Cursor, or any MCP client — look up orders and their production status, saved pending orders and virtual inventory, browse the product, media, style and framing catalog, price products, quote shipping and validate addresses. The server only reads and quotes: it never submits, changes or deletes an order. Hosted, no local install: connect with your own FinerWorks credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://finerworks.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http finerworks https://finerworks.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": {    "finerworks": {      "url": "https://finerworks.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 FinerWorks credentials.

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

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 FinerWorks web_api_key and app_key.

Tools

ToolTypeWhat it does
finerworks_get_accountreadGet account
finerworks_list_ordersreadList orders
finerworks_get_orderreadGet order
finerworks_get_order_statusreadGet order production status
finerworks_list_order_status_definitionsreadList order status definitions
finerworks_list_pending_ordersreadList pending orders
finerworks_list_virtual_inventoryreadList virtual inventory
finerworks_get_product_detailsreadGet product details
finerworks_get_pricesreadGet prices
finerworks_list_product_typesreadList product types
finerworks_list_media_typesreadList media types
finerworks_list_style_typesreadList style types
finerworks_list_static_productsreadList static products
finerworks_list_frame_collectionsreadList frame collections
finerworks_get_framereadGet frame details
finerworks_list_matsreadList mats
finerworks_list_glazingreadList glazing
finerworks_get_shipping_optionsreadGet shipping options
finerworks_validate_addressreadValidate address
finerworks_usage_statusmetaUsage status (free-tier meter)
finerworks_request_featuremetaRequest a missing feature
finerworks_upgrademetaUpgrade to Pro or Pro+
finerworks_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 account)$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 finerworks_upgrade (it returns a Stripe Checkout link). Cancel any time with finerworks_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running finerworks_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by FinerWorks.

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

工具

19

finerworks_get_account

Get account

The FinerWorks account these API keys belong to: username, email, billing and business addresses, account credits, shipping preferences and app details. The API keys, payment profile and third-party connection secrets are never returned. GET /v3/test_my_credentials.

无需输入参数。

finerworks_list_orders

List orders

List submitted print orders, newest first, with status, totals and dates. Filter by free text, production status, FinerWorks order ids, your own order POs (the order numbers from Shopify, Squarespace, etc.) or an order-date range. POST /v3/list_orders.

输入参数pagesearchstatusdate_toper_pagedate_fromorder_idsorder_posshow_cancelled

finerworks_get_order

Get order

One order in full: items, recipient, shipping method, status and totals. Needs the order GUID and the email address on the order. GET /v3/get_order.

输入参数order_guid必填order_email必填

finerworks_get_order_status

Get order production status

The current production status of orders (in production, shipped, ...), looked up by your order PO numbers or FinerWorks order ids. An order that is not found returns nothing. POST /v3/fetch_order_status.

输入参数order_idsorder_pos

finerworks_list_order_status_definitions

List order status definitions

All production statuses an order can have, with their ids. Use the id as the stable reference. GET /v3/list_order_status_definitions.

无需输入参数。

finerworks_list_pending_orders

List pending orders

Orders saved but held in a pending status, not yet submitted for production (nothing is billed until submitted). POST /v3/list_pending_orders.

输入参数idsskus

finerworks_list_virtual_inventory

List virtual inventory

The reusable print products (SKUs) saved in the account's virtual inventory: title, SKU, product code, image and price details. Filter by text, SKU, product code or product type. POST /v3/list_virtual_inventory.

输入参数pageskussearchper_pagesort_fieldproduct_codessort_directionproduct_type_ids

finerworks_get_product_details

Get product details

Details and pricing for up to 25 virtual inventory SKUs at given quantities. POST /v3/get_product_details.

输入参数products必填

finerworks_get_prices

Get prices

Price and price breakdown for up to 50 product codes or virtual inventory SKUs at given quantities. Nothing is ordered or billed. POST /v3/get_prices.

输入参数products必填

finerworks_list_product_types

List product types

The product types FinerWorks prints (fine art paper, canvas, wood, metal, cards, ...). POST /v3/list_product_types.

输入参数ids

finerworks_list_media_types

List media types

The papers and media FinerWorks prints on. POST /v3/list_media_types.

输入参数ids

finerworks_list_style_types

List style types

The print styles FinerWorks offers (for example gallery wrap or float mount). POST /v3/list_style_types.

输入参数ids

finerworks_list_static_products

List static products

Non-dynamic products, mostly accessories, that can be added to an order. POST /v3/list_static_products.

输入参数ids

finerworks_list_frame_collections

List frame collections

Frame collections (categories). Pass a collection id to list the frames in it; pass a product code to show only collections and frames compatible with that print product. POST /v3/list_collections.

输入参数idproduct_code

finerworks_get_frame

Get frame details

Details of one frame by id (from finerworks_list_frame_collections). POST /v3/frame_details.

输入参数id必填

finerworks_list_mats

List mats

The available mats (matting). POST /v3/list_mats.

输入参数id

finerworks_list_glazing

List glazing

The available glazing (glass and acrylic) options. POST /v3/list_glazing.

输入参数id

finerworks_get_shipping_options

Get shipping options

Shipping options and rates for one prospective order: a recipient address plus the SKUs and quantities. Returns the shipping_code values an order would need. Nothing is ordered or billed. POST /v3/list_shipping_options_multiple.

输入参数items必填recipient必填

finerworks_validate_address

Validate address

Check a recipient address and return FinerWorks' corrected version. Nothing is saved or ordered. POST /v3/validate_recipient_address.

输入参数recipient必填

版本历史

13
  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.0Oct 25, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成