FinerWorks MCP by usefulapi
Read FinerWorks orders, inventory, catalog, prices and shipping quotes; never submits an order.
使うべきか
品質と安全性
A
検出事項（5）
- LOWTool 'finerworks_list_order_status_definitions' name length outside 3-30 rangefinerworks_list_order_status_definitions 内
- LOWTool 'finerworks_list_virtual_inventory' name length outside 3-30 rangefinerworks_list_virtual_inventory 内
- LOWTool 'finerworks_list_static_products' name length outside 3-30 rangefinerworks_list_static_products 内
- LOWTool 'finerworks_list_frame_collections' name length outside 3-30 rangefinerworks_list_frame_collections 内
- LOWTool 'finerworks_get_shipping_options' name length outside 3-30 rangefinerworks_get_shipping_options 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~3,988トークン数（ツール定義）
~1.5 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 3.12%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"finerworks": {
"url": "https://finerworks.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://finerworks.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（19）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢finerworks_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.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_orders(search, status, order_ids, order_pos, date_from, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Text to search for in the order title or description.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Order status to filter by (see finerworks_list_order_status_definitions).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"order_ids": {
"description": "Optional list of FinerWorks order ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"order_pos": {
"description": "Your own order PO numbers.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"date_from": {
"description": "Orders placed on or after this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"date_to": {
"description": "Orders placed on or before this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"show_cancelled": {
"description": "Include cancelled orders (default true).",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-25 (default 10).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 25
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_order(order_guid, order_email)
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.
入力スキーマ
{
"type": "object",
"properties": {
"order_guid": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "The order's GUID (order_guid in finerworks_list_orders)."
},
"order_email": {
"type": "string",
"minLength": 3,
"maxLength": 254,
"description": "The email address on the order (billing or recipient email)."
}
},
"required": [
"order_guid",
"order_email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_order_status(order_pos, order_ids)
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.
入力スキーマ
{
"type": "object",
"properties": {
"order_pos": {
"description": "Your own order PO numbers.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"order_ids": {
"description": "FinerWorks order ids. Not needed when order_pos is given.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_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.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_pending_orders(ids, skus)
Orders saved but held in a pending status, not yet submitted for production (nothing is billed until submitted). POST /v3/list_pending_orders.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"description": "Optional list of pending order ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"skus": {
"description": "Only pending orders containing these SKUs.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_virtual_inventory(search, skus, product_codes, product_type_ids, sort_field, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"description": "Text to search for in the title or description.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"skus": {
"description": "Only these SKUs (up to 50).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"product_codes": {
"description": "Only these product codes (up to 50).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"product_type_ids": {
"description": "Optional list of product type ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"sort_field": {
"description": "Sort field (default id).",
"type": "string",
"enum": [
"id",
"title",
"file_name",
"file_size",
"updated",
"date_added"
]
},
"sort_direction": {
"description": "Sort direction (default DESC).",
"type": "string",
"enum": [
"ASC",
"DESC"
]
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"per_page": {
"description": "Results per page, 1-50 (default 10).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_product_details(products)
Details and pricing for up to 25 virtual inventory SKUs at given quantities. POST /v3/get_product_details.
入力スキーマ
{
"type": "object",
"properties": {
"products": {
"minItems": 1,
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "A virtual inventory SKU or a product code."
},
"quantity": {
"description": "Quantity, 1-999 (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 999
}
},
"required": [
"sku"
]
},
"description": "SKUs with quantities (up to 25)."
}
},
"required": [
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_prices(products)
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.
入力スキーマ
{
"type": "object",
"properties": {
"products": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "A virtual inventory SKU or a product code."
},
"quantity": {
"description": "Quantity, 1-999 (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 999
}
},
"required": [
"sku"
]
},
"description": "Product codes or SKUs with quantities (up to 50)."
}
},
"required": [
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_product_types(ids)
The product types FinerWorks prints (fine art paper, canvas, wood, metal, cards, ...). POST /v3/list_product_types.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"description": "Optional list of product type ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_media_types(ids)
The papers and media FinerWorks prints on. POST /v3/list_media_types.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"description": "Optional list of media ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_style_types(ids)
The print styles FinerWorks offers (for example gallery wrap or float mount). POST /v3/list_style_types.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"description": "Optional list of style ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_static_products(ids)
Non-dynamic products, mostly accessories, that can be added to an order. POST /v3/list_static_products.
入力スキーマ
{
"type": "object",
"properties": {
"ids": {
"description": "Optional list of static product ids to filter by.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_frame_collections(id, product_code)
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.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"description": "Collection id. Required to list the frames inside a collection.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"product_code": {
"description": "Only collections and frames compatible with this product code.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_frame(id)
Details of one frame by id (from finerworks_list_frame_collections). POST /v3/frame_details.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Frame id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_mats(id)
The available mats (matting). POST /v3/list_mats.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"description": "Only this mat id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_list_glazing(id)
The available glazing (glass and acrylic) options. POST /v3/list_glazing.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"description": "Only this glazing id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_get_shipping_options(recipient, items)
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.
入力スキーマ
{
"type": "object",
"properties": {
"recipient": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"company_name": {
"type": "string",
"maxLength": 150
},
"address_1": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address_2": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"state_code": {
"description": "US/Canada state or province code, e.g. AK.",
"type": "string",
"maxLength": 10
},
"province": {
"description": "Province or region for countries without state codes.",
"type": "string",
"maxLength": 100
},
"zip_postal_code": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"country_code": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two-letter country code, e.g. us."
},
"phone": {
"type": "string",
"maxLength": 40
},
"email": {
"type": "string",
"maxLength": 200
}
},
"required": [
"first_name",
"last_name",
"address_1",
"city",
"zip_postal_code",
"country_code"
],
"description": "Where the order would ship."
},
"items": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "A virtual inventory SKU or a product code."
},
"quantity": {
"description": "Quantity, 1-999 (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 999
}
},
"required": [
"sku"
]
},
"description": "SKUs (virtual inventory) with quantities."
}
},
"required": [
"recipient",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢finerworks_validate_address(recipient)
Check a recipient address and return FinerWorks' corrected version. Nothing is saved or ordered. POST /v3/validate_recipient_address.
入力スキーマ
{
"type": "object",
"properties": {
"recipient": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"company_name": {
"type": "string",
"maxLength": 150
},
"address_1": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address_2": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"state_code": {
"description": "US/Canada state or province code, e.g. AK.",
"type": "string",
"maxLength": 10
},
"province": {
"description": "Province or region for countries without state codes.",
"type": "string",
"maxLength": 100
},
"zip_postal_code": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"country_code": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two-letter country code, e.g. us."
},
"phone": {
"type": "string",
"maxLength": 40
},
"email": {
"type": "string",
"maxLength": 200
}
},
"required": [
"first_name",
"last_name",
"address_1",
"city",
"zip_postal_code",
"country_code"
],
"description": "The address to check."
}
},
"required": [
"recipient"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 19 件