Finerworks MCP for AI Agents

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

Tool to add images to a finerworks library.

Add or Update Gallery Collection

Tool to add or update personal gallery collections in GeoGalleries.

Delete Images

Tool to delete a list of image files from FinerWorks based on their unique GUIDs.

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

Tool to retrieve order production status and tracking details from FinerWorks.

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

Tool to retrieve pricing information for FinerWorks products.

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.

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

Tool to list all available production status definitions an order can have once it has completed.

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

Tool to update image metadata in FinerWorks based on unique GUIDs.

Update User

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

Update Virtual Inventory

Tool to update virtual inventory items within a user's account.

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/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

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

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List available media types for prints' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Finerworks API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Finerworks Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List available fine art media types for printing'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Finerworks actions with your Agent

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 OAuth handling with automatic token refresh and rotation
  • 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
FAQ

Frequently asked questions

Yes, Finerworks requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Finerworks.It takes 30 seconds.

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

Start building