MCP MeasureMCP Measure

인덱스 관측됨

FinerWorks MCP by usefulapi

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

사용해야 할까요

품질 및 안전성

A
설명 품질
92%
스키마 완전성
87%
이름 품질
75%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (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개