Browse guides⌄
AI Assistants
For gallery administrators
Every tool an assistant can use
The complete list of GalleryCamp's MCP tools — what each one does, and which need a Read & write connection.
11 min read
An assistant works in GalleryCamp through a fixed set of tools, each doing one job: find artworks, record a payment, invite a collector to a viewing room. Most assistants show the tool's name as they use it, so this list doubles as a way to read along with what yours is doing.
There are 72 tools. In the Access column:
- Read — available on every connection. Looks things up and changes nothing.
- Write — needs a Read & write connection. A Read only connection isn't offered these at all.
- Write · outside — can also reach someone outside the gallery, by email or on your live website, when the assistant is asked to. Assistants are told to check with you before doing that. See Access, safety and troubleshooting.
You never need to name a tool. Ask in plain words and the assistant picks the right one; What you can do with an AI assistant shows how.
Getting started
| Tool | What it does | Access |
|---|---|---|
get_gallery |
Which gallery this is, the connection's access level, your plan and artwork limit, and the headline numbers: inventory by status and value, open inquiries, orders and revenue, recent activity and upcoming events. Assistants call it first. | Read |
get_reference_data |
The gallery's own vocabulary: artwork categories and mediums, artist, event and blog categories, blog tags, locations, tax rates, and the custom fields in use on artworks and artists. | Read |
search |
Quick search across artworks, artists and collectors by name or title — how an assistant turns a name you mention into a record. | Read |
Artworks
| Tool | What it does | Access |
|---|---|---|
list_artworks |
Search and filter the inventory by words in the title, inventory number, artist, medium or description, and by status, artist, location, category, medium, custom fields or online-store listing. Archived works only when asked. | Read |
get_artwork |
One work in full: details, prices, custom fields, images, categories and exhibitions. Can add its provenance, valuations, condition reports, edition, order history and change history. | Read |
save_artwork |
Create a work, or change any of its fields: details, dimensions, price and who can see it, status, location, cost and commission, categories, custom fields, images. New works count against your plan's limit. | Write |
archive_artworks |
Archive works you no longer handle, or restore archived ones. The only way an assistant can remove a work. | Write |
add_artwork_images |
Copy images from web addresses into GalleryCamp and attach them to a work. Images that can't be fetched are reported, not stored. | Write |
hold_artwork |
Reserve a work for one collector, optionally until a date. | Write |
release_artwork |
Take a hold off a work and put it back on sale. | Write |
add_provenance |
Add an owner to the end of a work's provenance chain. | Write |
add_appraisal |
Record a valuation. Valuations feed the insurance report. | Write |
add_condition_report |
Record an inspection of a work's condition. | Write |
create_edition |
Turn a work into a numbered edition, creating the rest of the run and any proofs as new works. Counts against your plan's limit, and can't be undone by the assistant. | Write |
Artists
| Tool | What it does | Access |
|---|---|---|
list_artists |
Search the artists you work with by name, bio, website, city or country, and filter by artist category or custom field. | Read |
get_artist |
One artist in full: bio, statement, contact details, commission rate, categories, custom fields and their works. | Read |
save_artist |
Create an artist, or change their profile, contact details, commission rate, categories or custom fields. | Write |
archive_artist |
Archive an artist you no longer represent. They stay credited on their works. Restoring one is done in the dashboard. | Write |
Collections and exhibitions
| Tool | What it does | Access |
|---|---|---|
list_collections |
Your collections, public or private. | Read |
get_collection |
One collection with its works, in order. | Read |
save_collection |
Create a collection or change its name, description and visibility. | Write |
set_collection_artworks |
Add works to a collection, remove them, or set the whole list in order. | Write |
list_exhibitions |
Your exhibitions, most recent first. | Read |
save_exhibition |
Create an exhibition or change its dates, text, artist and location. | Write |
Consignments and loans
| Tool | What it does | Access |
|---|---|---|
list_consignments |
Consignments, loans and works on approval, coming in or going out. Can show only overdue ones. | Read |
get_consignment |
One agreement with its works and their status. | Read |
save_consignment |
Create an agreement or change its terms, dates, commission and status. Activating an outgoing loan marks its works On loan. | Write |
update_consignment_item |
Mark one work on an agreement Returned or Sold, or change its agreed price, commission or notes. The artwork's status follows. | Write |
Collectors and inquiries
| Tool | What it does | Access |
|---|---|---|
list_customers |
Search collectors and contacts by email, name, phone, city or notes. | Read |
get_customer |
One collector: contact details, tags, tax status, inquiries and orders. Can add the team's notes, email correspondence, open deals and change history. | Read |
save_customer |
Create a collector or change their details, tags and tax exemption. Refuses a duplicate email and points to the existing record. | Write |
list_inquiries |
Inquiries from the website, viewing rooms and the dashboard, newest first. Can show only those still waiting on a reply. | Read |
create_inquiry |
Log an inquiry that came in by phone, email or in person, creating the collector if they're new. | Write |
update_inquiry |
Mark an inquiry Responded, Closed or Spam, or back to New. | Write |
Deals and offers
| Tool | What it does | Access |
|---|---|---|
list_deals |
The sales pipeline, most recently active first. Can leave out deals already won or lost. | Read |
get_deal |
One deal: the collector, the works, every offer and whether it was delivered, notes, and optionally the emails on it. | Read |
save_deal |
Start a deal or move one along: stage, works, value, expected close. Marking it Lost releases every hold on its works. | Write |
make_offer |
Put a price to the collector on a deal. Saved as a draft, or emailed to the collector when asked. | Write · outside |
update_offer |
Change an offer's terms, send or revise it (both email the collector), or record it as accepted, declined or withdrawn. Accepting marks the deal Won, creates a draft order and marks the works Sold. | Write · outside |
Orders and payments
| Tool | What it does | Access |
|---|---|---|
list_orders |
Orders and invoices, newest first. Search by order number or collector, and filter by status or by online-store orders. | Read |
get_order |
One order: lines with tax, totals, collector, status and the payments against it. | Read |
preview_order_tax |
Work out the tax an order would carry, without saving anything. | Read |
create_order |
Draft an order for a collector, with tax worked out from your rates. Emails no one. | Write |
update_order |
Change an order's collector, shipping, discount, tax or notes, or cancel or refund it, which puts its works back on sale. | Write |
send_order |
Issue a draft order, reserving its works. Emails the collector the invoice, with a card payment link if you take card payments — or issues it quietly when asked. | Write · outside |
get_payment_link |
The card payment link for an order, for you to pass on. Emails no one. | Write |
record_payment |
Record money received — a wire, check, cash. Paid in full, the order's works become Sold. | Write |
Artist payouts
| Tool | What it does | Access |
|---|---|---|
list_unsettled_sales |
What each artist is owed from paid sales not yet settled, or every sale and commission split for one artist. | Read |
list_payouts |
Payout statements raised for artists, with status and totals. | Read |
get_payout |
One payout statement with every sale on it. | Read |
create_payout |
Raise a payout statement from an artist's unsettled sales. Records what you owe; moves no money. | Write |
update_payout |
Approve a payout, mark it paid and how, adjust it, or void it so its sales can be settled again. | Write |
Viewing rooms
| Tool | What it does | Access |
|---|---|---|
list_viewing_rooms |
Your viewing rooms, with how many works and recipients each has and how many have opened it. | Read |
get_viewing_room |
One room: settings, statement and works in order. | Read |
get_viewing_room_activity |
Who opened a room, how often and for how long, and which works drew views, zooms, favourites and inquiries — for the room, or for one collector. | Read |
save_viewing_room |
Create a room or change its title, statement, cover, dates, visibility, price display, passcode and what visitors can do. Publishing sends it to no one. | Write |
set_viewing_room_artworks |
Add works to a room, remove them, or set the whole list in order, each with its own caption and price display. | Write |
invite_to_viewing_room |
Create a collector's private link into a room, and email them an invitation when asked. | Write · outside |
Events
| Tool | What it does | Access |
|---|---|---|
list_events |
Openings, talks and receptions, latest first. | Read |
get_event |
One event in full. | Read |
list_event_rsvps |
An event's guest list and total number of guests. | Read |
save_event |
Create an event or change its dates and times, description, image, location, categories and RSVP settings. Published events show on your website if it has events turned on. | Write |
add_event_rsvp |
Add a guest to an event by hand. Sends them nothing. | Write |
Journal and website
| Tool | What it does | Access |
|---|---|---|
list_blog_posts |
Your journal posts, newest first, without their text. | Read |
get_blog_post |
One post with its full text, search-engine fields, categories and tags. | Read |
save_blog_post |
Write a post or change one, including scheduling it with a future publish date. Bylined to the person who approved the connection. | Write |
list_websites |
Your websites, whether each is live, its domain and which sections it shows. | Read |
update_website |
Change a site's headline copy and contact address, turn its shop, blog or events on or off, or publish or unpublish it. Takes effect on the live site immediately. | Write · outside |
Reports, notes and history
| Tool | What it does | Access |
|---|---|---|
get_report |
Run the sales, inventory, insurance or viewing-room engagement report over a period you choose. | Read |
get_record_history |
Who changed what, field by field, on one record or across all records of a kind. | Read |
list_notes |
The team's dated notes on an artwork, artist or collector. | Read |
add_note |
Add a dated note to an artwork, artist or collector, credited to the person who approved the connection. | Write |