MCP-Server

Appraisily

com.appraisily/mcp
Commerce & Retail Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Provides public auction comparables, artist and hallmark research, appraisal guidance, and professional appraisal screening workflows.

create_appraisal_start_link
Create Appraisal Start Link
Create a tracked Appraisily /start link when a user is ready to submit an item for appraisal. Use this after giving basic guidance when the user indicates intent to start, order, upload photos, get a report, insure an item, donate an item, handle estate needs, or document value. This does not create an order, collect payment, upload files, or write customer data; it only returns a URL with OpenAI app attribution.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'campaign': {'type': 'string', 'maxLength': 80, 'description': 'Optional UTM campaign override.'}, 'itemType': {'type': 'string', 'maxLength': 80, 'description': 'Short item category such as painting, antique chair, jewelry, silver, or sculpture.'}, 'userGoal': {'type': 'string', 'maxLength': 80, 'description': 'Short user goal such as resale, insurance, estate, donation, or curiosity.'}}}
create_pro_screener_workspace_link
Create Pro Screener Workspace Link
Create a tracked Appraisily Pro Screener workspace link for an appraiser or valuation team. Use this when a professional user wants to open the product, continue an existing session, or move a ChatGPT research packet into Pro Screener review. This returns a URL only; it does not create a customer order, upload files, or sign a report.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'content': {'type': 'string', 'maxLength': 80, 'description': 'Optional UTM content label.'}, 'campaign': {'type': 'string', 'maxLength': 80, 'description': 'Optional UTM campaign override.'}, 'sessionId': {'type': 'string', 'maxLength': 120, 'description': 'Optional existing Pro Screener session ID. If omitted, returns the Pro Screener product URL.'}}}
fetch
Fetch Appraisily Document
Fetch one Appraisily public knowledge document by id after using search. Use this when the user needs a specific public Appraisily source, sample-report link, or fuller guidance from a search result. Do not use this for private customer records, order status, or report retrieval; this connector is public and read-only.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'The id returned by the search tool.'}}}
get_artist
Get Artist Page
Fetch one Appraisily public /artist page by slug, artist URL, or search query. Returns name, public page URL, aliases, genres, market summary, recent sold lots, top houses, related artists, and page extras such as birth/death years. Use after search_artists when the user needs one artist page. This is market context, not a signed appraisal or authentication.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Public /artist slug such as pablo-picasso.'}, 'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Artist name used when a slug is not known.'}, 'artistUrl': {'type': 'string', 'format': 'uri', 'description': 'Public Appraisily /artist URL for one artist.'}}}
get_pro_screener_pdf
Get Lotbook PDF Link
Return the Lotbook PDF URL once the report is ready. Promotional runs return a durable public assets.appraisily.com/promotional-lotbook URL. No login is required for those sessions. Private client packets still use a short-lived signed URL. Never publish customer PDFs to /appraisals or /sessions.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Lotbook session ID owned by the signed-in Appraisily user.'}}}
get_pro_screener_result
Get Pro Screener Result
Fetch compact comparable results and analysis summary for an existing Pro Screener session. Use this when an appraiser wants to review evidence already generated by Pro Screener. The response is intentionally compact and excludes private customer PII beyond the professional session evidence.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Maximum top comparables to return.'}, 'sessionId': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Existing Pro Screener session ID.'}}}
get_pro_screener_status
Get Pro Screener Status
Fetch status for a Lotbook session. Public promotional runs do not need Appraisily sign-in. Use this after start_promotional_pro_screener_run or start_pro_screener_run returns a sessionId. Private client sessions still resolve against the signed-in Appraisily user when present.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Existing Pro Screener session ID.'}}}
get_public_sample_report
Get Public Sample Report
Return a canonical public Appraisily sample report URL. Use this when a user wants to inspect example report formats before starting an appraisal. Choose the closest category if the user mentions insurance, tax, donation, professional, instant, or general report examples.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'category': {'enum': ['instant', 'regular', 'professional', 'insurance', 'tax', 'pro-screener'], 'type': 'string', 'description': 'The sample report category to return.'}}}
get_silver_hallmark
Get Silver Hallmark
Fetch one Appraisily /marks maker page: mark texts, dates, source citations, and hosted line-drawing plus oxidized reconstruction image URLs for that maker’s variants. Use after search_silver_hallmarks when the user needs the public oxidized hallmark image or the full maker-page image pair. Oxidized images are AI-assisted reconstructions for visual comparison, not photographs or authentication evidence.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Public /marks slug such as gorham-and-co-7f4935c6.'}, 'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Maker name or mark text used when a slug is not known.'}, 'markUrl': {'type': 'string', 'format': 'uri', 'description': 'Public Appraisily /marks URL for one maker.'}}}
prepare_pro_screener_case_packet
Prepare Pro Screener Case Packet
Prepare a professional appraisal screening packet from item context before an appraiser starts or reviews a Pro Screener case. Use this for credentialed appraisers and valuation teams who need missing-photo checks, missing-fact checks, review flags, and next questions. This tool organizes research inputs only; it does not issue a final value conclusion or signed appraisal.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'knownFacts': {'type': 'array', 'items': {'type': 'string', 'maxLength': 180}, 'maxItems': 20, 'description': 'Known facts from the client or appraiser notes.'}, 'intendedUse': {'type': 'string', 'maxLength': 120, 'description': 'Professional use case such as triage, insurance, estate, donation, resale, or report prep.'}, 'itemCategory': {'type': 'string', 'maxLength': 80, 'description': 'Item category such as oil painting, silver bowl, antique chair, jewelry, ceramic vase, or sculpture.'}, 'targetValueUsd': {'type': 'number', 'description': 'Optional client-stated or working reference value in USD.', 'exclusiveMinimum': 0}, 'availablePhotos': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'maxItems': 20, 'description': 'Available photo types such as front, back, signature, label, condition, scale, underside.'}, 'subjectDescription': {'type': 'string', 'maxLength': 1500, 'description': 'Short professional description of the item, visible features, medium/materials, and context.'}}}
search
Search Appraisily Knowledge
Search Appraisily public appraisal guidance, service information, sample reports, and photo-preparation content. Use this when a user is exploring whether an item needs an art, antique, insurance, tax, estate, donation, or general online appraisal. Use this before fetch when the user asks broad questions such as what photos to upload, which appraisal path fits, or whether Appraisily handles an item type. This tool returns public information only; it never returns customer orders, private appraisals, internal notes, or raw database rows.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Maximum number of results to return.'}, 'query': {'type': 'string', 'minLength': 1, 'description': 'The user search query.'}, 'category': {'type': 'string', 'description': 'Optional category hint such as art, antiques, insurance, tax, photos, or sample reports.'}}}
search_artists
Search Artists
Search Appraisily public artist directory pages and compact sold-lot context. Return at most 6 artists per query, with up to 6 recent lots on the top match. Use this for artist identification and market context, not as a signed appraisal or authentication.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'Maximum number of artists, capped at 6.'}, 'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Artist name such as Pablo Picasso, Monet, or Warhol.'}}}
search_auction_comparables
Search Auction Comparables
Search past public auction results for compact market context. Return at most 6 sold lots per query. Use this only as research evidence, not as a final appraisal or formal value conclusion. This tool is read-only and returns no customer data.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['keyword'], 'properties': {'limit': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'Maximum number of comparable results, capped at 6.'}, 'keyword': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Short auction search phrase such as Tiffany favrile vase or 19th century mahogany chest.'}, 'minPrice': {'type': 'number', 'minimum': 0, 'description': 'Optional minimum realized price filter.'}}}
search_pro_screener_comparables
Search Pro Screener Comparables
Search Appraisily valuation infrastructure for comparable auction lots for professional appraisal screening. Use this only for authenticated appraiser workflows and research support. Return compact comparable evidence for review; do not present the results as a final appraisal conclusion.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'maxResults': {'type': 'integer', 'maximum': 24, 'minimum': 1, 'description': 'Maximum compact comparable rows to return.'}, 'maxValueUsd': {'type': 'number', 'description': 'Optional maximum price filter/reference in USD.', 'exclusiveMinimum': 0}, 'minValueUsd': {'type': 'number', 'description': 'Optional minimum price filter/reference in USD.', 'exclusiveMinimum': 0}, 'searchTerms': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 12, 'description': 'Explicit market-comparable search terms. Use when the appraiser supplies preferred terms.'}, 'itemCategory': {'type': 'string', 'maxLength': 80, 'description': 'Item category such as painting, sculpture, antique chair, silver, jewelry, or ceramics.'}, 'targetValueUsd': {'type': 'number', 'description': 'Optional reference value in USD.', 'exclusiveMinimum': 0}, 'subjectDescription': {'type': 'string', 'maxLength': 1500, 'description': 'Subject description used to anchor comparable search.'}}}
search_silver_hallmarks
Search Silver Hallmarks
Search Appraisily public silver hallmark and maker-mark catalog records from /marks. Return at most 6 makers per query, with mark texts, dates, line-drawing and oxidized reconstruction image URLs when Appraisily hosts them, and optional sold-to-melt context. Use this as catalog context only. A mark, drawing, or oxidized reconstruction does not authenticate an object or establish value.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'Maximum number of hallmark records, capped at 6.'}, 'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'Maker name or mark text such as Gorham, Tiffany, or lion anchor G.'}}}
start_promotional_pro_screener_run
Start Promotional Lotbook PDF
Start a promotional Appraisily Lotbook run whose finished PDF includes the Appraisily logo. Use this for marketing, demos, social posts, or other public Appraisily-branded leave-behinds. Do not use this for a client/white-label packet; that is start_pro_screener_run, which stays unbranded. No Appraisily login is required. Provide a public HTTPS photo. Optional notes help the research. Returns a sessionId immediately; poll get_pro_screener_status, then get_pro_screener_pdf for a public assets.appraisily.com/promotional-lotbook URL. The submitted photo and finished PDF are public marketing artifacts owned by Appraisily.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'notes': {'type': 'string', 'maxLength': 1500, 'description': 'Optional object notes: artist, medium, size, inscriptions, provenance, or promo caption context.'}, 'imageUrl': {'type': 'string', 'format': 'uri', 'maxLength': 2000, 'description': 'Public HTTPS URL of the object photo. Do not use localhost or private network URLs.'}, 'imageBase64': {'type': 'string', 'maxLength': 16000000, 'description': 'Optional raw or data-URL base64 image when no HTTPS URL is available.'}, 'declaredValueUsd': {'type': 'number', 'description': 'Optional client-stated value in USD.', 'exclusiveMinimum': 0}}}
start_pro_screener_run
Start Lotbook Run
Start a private Appraisily Lotbook (Pro Screener) run from a signed-in Appraisily account and a photo. Use this when the user wants Lotbook, Pro Screener, or a professional screening report from ChatGPT after they have signed in. This creates a private session, queues the same agent the website uses, and returns immediately with a sessionId. Do not wait for the full 8–12 minute run. Prefer a public HTTPS imageUrl. If the client provided image bytes, pass imageBase64. Then poll get_pro_screener_status.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'notes': {'type': 'string', 'maxLength': 1500, 'description': 'Optional object notes from the user: artist, medium, size, inscriptions, or provenance.'}, 'imageUrl': {'type': 'string', 'format': 'uri', 'maxLength': 2000, 'description': 'Public HTTPS URL of the object photo. Do not use localhost or private network URLs.'}, 'imageBase64': {'type': 'string', 'maxLength': 16000000, 'description': 'Optional raw or data-URL base64 image when no HTTPS URL is available.'}, 'declaredValueUsd': {'type': 'number', 'description': 'Optional client-stated value in USD.', 'exclusiveMinimum': 0}}}
Hinzugefügt
get_pro_screener_pdf
17. September 2026 12:33
Hinzugefügt
get_pro_screener_result
17. September 2026 12:33
Hinzugefügt
get_pro_screener_status
17. September 2026 12:33
Hinzugefügt
start_promotional_pro_screener_run
17. September 2026 12:33
Hinzugefügt
start_pro_screener_run
17. September 2026 12:33
Hinzugefügt
search_pro_screener_comparables
17. September 2026 12:33
Hinzugefügt
create_pro_screener_workspace_link
17. September 2026 12:33
Hinzugefügt
prepare_pro_screener_case_packet
17. September 2026 12:33
Hinzugefügt
get_silver_hallmark
17. September 2026 12:33
Hinzugefügt
search_silver_hallmarks
17. September 2026 12:33
Hinzugefügt
get_artist
17. September 2026 12:33
Hinzugefügt
search_artists
17. September 2026 12:33
Hinzugefügt
search_auction_comparables
17. September 2026 12:33
Hinzugefügt
create_appraisal_start_link
17. September 2026 12:33
Hinzugefügt
get_public_sample_report
17. September 2026 12:33
Hinzugefügt
fetch
17. September 2026 12:33
Hinzugefügt
search
17. September 2026 12:33