Finerworks MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Finerworks MCP or direct API to place print orders, update artwork inventory, track order status, and send customer notifications through natural language.

Finerworks logoFinerworks
Api Key

FinerWorks is an online platform for fine art and photo printing services. Artists and photographers use it to order custom prints and manage print inventory efficiently.

33 Tools

Try Finerworks now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Finerworks
Try asking
TOOLS

Supported Tools

Every Finerworks action and event your agent gets out of the box.

Add Images

Add up to five images with metadata and URIs to a FinerWorks library.

Add or Update Gallery Collection

Tool to add or update personal gallery collections in GeoGalleries.com.

Delete Images

Soft-delete image files from a FinerWorks library by GUID; for inventory-library images, this also removes assigned virtual inventory products.

Delete Pending Orders

Tool to remove orders from temporary storage that were saved as pending.

Delete Virtual Inventory

Tool to delete virtual inventory products by SKU.

Disconnect Virtual Inventory

Tool to disconnect ALL virtual inventory items from a 3rd party platform.

Fetch Order Status

Retrieve FinerWorks order status and shipment tracking details by order IDs or purchase order references.

Get Company Info

Tool to get essential information about FinerWorks including site identifier, company address, and operating hours.

Get Frame Details

Tool to retrieve detailed specifications for a specific frame by ID.

Get Prices

Retrieve pricing breakdowns for FinerWorks product SKUs and quantities.

Get Shipping Options IDs

Tool to list all available shipping option IDs from FinerWorks.

Get User

Retrieves the authenticated user's FinerWorks account profile including billing/business addresses, account credits, shipping preferences, connected platforms, and gallery settings.

List File Selection

Tool to retrieve the list of currently selected files by their master guid.

List Frame Collections

Retrieve available frame collections and categories from FinerWorks.

List Galleries

Tool to list galleries setup in GeoGalleries.com for the user's account.

List Gallery Themes

Tool to retrieve available themes for GeoGalleries.

List Glazing

Retrieve available glazing and glass options from FinerWorks.

List Images

Tool to retrieve a paginated list of image files uploaded to your FinerWorks account.

List Mats

Retrieve available matting options from FinerWorks for framing products.

List Media Types

Retrieve available print media types from FinerWorks.

List Order Status Definitions

List FinerWorks order status definitions and their IDs and labels.

List Product Types

Retrieve FinerWorks product types (print categories like Canvas Prints, Metal Prints, Posters, etc.).

List Shipping Options Multiple

Retrieve shipping options and rates for multiple orders in a batch request.

List Style Types

Retrieves available print style types from FinerWorks.

List Virtual Inventory

Tool to retrieve a user's virtual inventory products from their FinerWorks account.

Save Pending Orders

Tool to save orders to temporary pending storage.

Submit Orders

Tool to submit up to five new orders.

Update App Details

Tool to update the details assigned to the app_key being used.

Update File Selection

Tool to update a user's currently selected image files using the selection key.

Update Images

Update image metadata by GUID, including titles, descriptions, visibility and gallery assignments; inventory-library images also have their assigned virtual inventory products removed.

Update User

Tool to update various features of a user's account profile.

Update Virtual Inventory

Update up to 50 existing virtual inventory items by SKU, including pricing, stock quantities, descriptions, and third-party integrations.

Validate Recipient Address

Tool to validate and test a recipient address before submitting an order to ensure delivery accuracy.

SETUP GUIDE

Connect Finerworks MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["finerworks"],
  mcp: true,
});
Create a session scoped to Finerworks and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List available fine art media types for printing",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Finerworks request
SETUP GUIDE

Connect Finerworks API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["finerworks"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Finerworks
3

Run Finerworks tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List available fine art media types for printing" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Finerworks tool calls through the session, and print the final answer

Why Use Composio?

AI Native Finerworks Integration

  • Supports both Finerworks MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Finerworks data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke Finerworks access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Finerworks
  • Scoped, least privilege access to Finerworks resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Finerworks.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Finerworks tool your agent needs.Free to start.

Start building