How to integrate Finerworks MCP with Codex

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Finerworks MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

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

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Finerworks MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Finerworks with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Finerworks MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the Finerworks MCP server, and what's possible with it?

The Finerworks MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your FinerWorks account. It provides structured and secure access to your fine art and photo printing services, so your agent can perform actions like uploading artwork, managing orders, updating account info, and exploring product options on your behalf.

  • Artwork upload and management: Easily add new images to your FinerWorks library, complete with metadata and image URIs, so your inventory is always up to date.
  • Order submission and tracking: Ask your agent to submit batches of print orders or retrieve shipping options, streamlining your print fulfillment process.
  • Product and media exploration: Instantly list available product types, media types, and style options to help you select the perfect materials for your artwork.
  • Account and profile updates: Let your agent fetch or update your user profile, including business information, billing details, and payment profiles, as your needs change.
  • Credential verification and file selection: Test your credentials for peace of mind, or update which image files are selected for current projects—all without manual steps.

Conclusion

You've successfully integrated Finerworks with Codex using Composio's MCP server. Now you can interact with Finerworks directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Finerworks operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Finerworks operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
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.

FAQ

Frequently asked questions

With a standalone Finerworks MCP server, the agents and LLMs can only access a fixed set of Finerworks tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Finerworks and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Finerworks tools.

Yes, absolutely. You can configure which Finerworks scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Finerworks data and credentials are handled as safely as possible.

Start with Finerworks.It takes 30 seconds.

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

Start building