Provenio — Art Intelligence

Official27 toolsLive

by mildo-ai

Art provenance intelligence — 282K-node knowledge graph with cited answers and honest gaps.

Captured live from the server via tools/list.

search_artists

Cost: ~0.4s. Shortlist person nodes by name/nationality/era. Returns [{id, display_name, birth_year, death_year, nationality, era}]. Use when: you have a name but no person ID. Try a partial name if exact match fails (e.g. 'Basquiat' not 'Jean-Michel Basquiat'). Do NOT use if: you already know the ID — call get_artist directly (one call). Returns person IDs in 'person:slug' format — pass these directly as the 'artist' parameter in search_artworks. STOP after this unless you need a specific artist's full profile.

Parameters4

query	string	required	Free-text substring match on display_name and id (case-insensitive). Use empty string '' to browse by filters only.
nationality	string	optional	Substring match, e.g. 'dutch', 'japanese', 'french'. Combined with other filters as AND.
era	string	optional	Substring match against era, e.g. 'baroque', 'modernism', 'contemporary'.
limit	integer	optional	Max rows returned. Default 20. Check has_more to know if more exist.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text substring match on display_name and id (case-insensitive). Use empty string '' to browse by filters only."
    },
    "nationality": {
      "description": "Substring match, e.g. 'dutch', 'japanese', 'french'. Combined with other filters as AND.",
      "type": "string"
    },
    "era": {
      "description": "Substring match against era, e.g. 'baroque', 'modernism', 'contemporary'.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Max rows returned. Default 20. Check has_more to know if more exist.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_artworks

Cost: ~0.5s. Shortlist artworks by title/artist/medium/date, or risk-filter (provenance_risk, attribution_status). Returns summary rows. Use when: you need a list, not one work's detail. Do NOT use if: you know the artwork ID — call get_artwork (one call contains iconography + custody + polity + transactions). Do NOT chain multiple search_artworks calls for the same work — use get_artwork after you have the ID. Do NOT put artist names in the query field alone — use the artist filter with the person ID slug (e.g. 'person:jean-michel-basquiat'). If title is ambiguous, combine query + artist filter. Title match is substring (ILIKE %query%). For best results, use the artist filter rather than embedding artist name in query. Note: when provenance_risk filter is used, returns coverage_gaps: ['no_custody_history'] when the matching custody record pool is smaller than expected — interpret this as a data-density limitation, not a clean result. STOP after this unless you need deep detail on ONE artwork.

Parameters8

query	string	required	Substring match on title and id (ILIKE %query%). Empty '' browses all. Do NOT embed artist names here — use the artist parameter instead.
artist	string	optional	Filter by creator — person ID slug ('picasso') or full 'person:...' form (e.g. 'person:jean-michel-basquiat'). Obtain this from search_artists if needed.
medium	string	optional	Substring match on medium, e.g. 'oil', 'bronze', 'watercolor'.
date_from	integer	optional	Earliest production year (inclusive).
date_to	integer	optional	Latest production year (inclusive).
attribution_status	string	optional	Filter by authorship status. 'disputed' surfaces contested attributions; 'workshop' surfaces 'Workshop of X' works; 'anonymous' surfaces unattributed; 'single_author' surfaces those with confirmed creator.
provenance_risk	string	optional	Surface artworks whose custody_history matches a risk profile. Use for bulk due-diligence audits.
limit	integer	optional	Max rows. Default 10.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Substring match on title and id (ILIKE %query%). Empty '' browses all. Do NOT embed artist names here — use the artist parameter instead."
    },
    "artist": {
      "description": "Filter by creator — person ID slug ('picasso') or full 'person:...' form (e.g. 'person:jean-michel-basquiat'). Obtain this from search_artists if needed.",
      "type": "string"
    },
    "medium": {
      "description": "Substring match on medium, e.g. 'oil', 'bronze', 'watercolor'.",
      "type": "string"
    },
    "date_from": {
      "description": "Earliest production year (inclusive).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "date_to": {
      "description": "Latest production year (inclusive).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "attribution_status": {
      "description": "Filter by authorship status. 'disputed' surfaces contested attributions; 'workshop' surfaces 'Workshop of X' works; 'anonymous' surfaces unattributed; 'single_author' surfaces those with confirmed creator.",
      "type": "string",
      "enum": [
        "single_author",
        "workshop",
        "disputed",
        "anonymous"
      ]
    },
    "provenance_risk": {
      "description": "Surface artworks whose custody_history matches a risk profile. Use for bulk due-diligence audits.",
      "type": "string",
      "enum": [
        "nazi_era_gap",
        "colonial_seizure",
        "forced_sale",
        "repatriation_pending",
        "knoedler_forgery_window"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Max rows. Default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_auction_history

Cost: ~0.7s. Auction transaction rows with optional percentile_summary=true to also return P25/50/75/90 + realized-vs-estimate in ONE call. Use when: need lot-level prices OR percentile stats. Do NOT use if: you only need per-artist aggregates — use query_market_summary. SINGLE-CALL FRIENDLY — combine filters + percentile_summary for appraisal work.

Parameters8

artist_name	string	optional	Artist name substring, e.g. 'Basquiat', 'Gauguin'. Case-insensitive.
artwork_id	string	optional	Filter by specific artwork ID slug or full 'artwork:...'.
date_from	string	optional	ISO date or year, e.g. '1990' or '1990-05-01'.
date_to	string	optional	ISO date or year for upper bound.
min_price_usd	integer	optional	Minimum price in USD. Uses price_usd_2024_cpi when available, else nominal USD. 1e6 = 1 million.
medium_keyword	string	optional	Substring match against artwork medium (joins via artwork_id). E.g. 'oil', 'bronze', 'watercolor', 'print'.
percentile_summary	boolean	optional	If true, also return P25/P50/P75/P90 percentiles and avg realized/estimate ratio over the filtered set. Use for appraisal / comp-set analysis.
limit	integer	optional	Max rows. Default 10.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_name": {
      "description": "Artist name substring, e.g. 'Basquiat', 'Gauguin'. Case-insensitive.",
      "type": "string"
    },
    "artwork_id": {
      "description": "Filter by specific artwork ID slug or full 'artwork:...'.",
      "type": "string"
    },
    "date_from": {
      "description": "ISO date or year, e.g. '1990' or '1990-05-01'.",
      "type": "string"
    },
    "date_to": {
      "description": "ISO date or year for upper bound.",
      "type": "string"
    },
    "min_price_usd": {
      "description": "Minimum price in USD. Uses price_usd_2024_cpi when available, else nominal USD. 1e6 = 1 million.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "medium_keyword": {
      "description": "Substring match against artwork medium (joins via artwork_id). E.g. 'oil', 'bronze', 'watercolor', 'print'.",
      "type": "string"
    },
    "percentile_summary": {
      "description": "If true, also return P25/P50/P75/P90 percentiles and avg realized/estimate ratio over the filtered set. Use for appraisal / comp-set analysis.",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "description": "Max rows. Default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_artist

Cost: ~1s. Composite artist profile — identity + reception + 1-hop influence in/out + education + market aggregates. SINGLE CALL USUALLY SUFFICIENT. Use when: you have an artist ID and need their full picture. Do NOT chain with get_influence_network unless you need depth > 1. Do NOT use for multi-artist comparison — use query_market_summary.

Parameters1

artist_id

string

required

Person ID slug ('paul-gauguin') or full 'person:...' ID. Case-sensitive slug.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Person ID slug ('paul-gauguin') or full 'person:...' ID. Case-sensitive slug."
    }
  },
  "required": [
    "artist_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_artwork

Cost: ~1s. Composite artwork profile — metadata + Panofsky subjects + reception + custody + polity + transactions. SINGLE CALL USUALLY SUFFICIENT. Use when: you have an artwork ID. Do NOT chain with get_provenance_chain unless you need gap-risk flags specifically.

Parameters1

artwork_id

string

required

Artwork ID slug or full 'artwork:...' ID.

Raw schema

{
  "type": "object",
  "properties": {
    "artwork_id": {
      "type": "string",
      "description": "Artwork ID slug or full 'artwork:...' ID."
    }
  },
  "required": [
    "artwork_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_movement_context

Cost: ~0.5s. Concept node + linked artworks. Pass cross_tradition=true for hasFunctionalAnalog concepts (lotus↔rose). SINGLE CALL USUALLY SUFFICIENT. Use when: definitional context or iconography cluster. Do NOT use for artwork filters — use search_artworks.

Parameters3

concept_id	string	required	Concept ID slug ('period-dutch-golden-age', 'movement-impressionism', 'iconography-lotus-purity') or full 'concept:...' ID.
cross_tradition	boolean	optional	If true, also return concepts linked via hasFunctionalAnalog for cross-tradition analogy queries.
limit	integer	optional	Max linked artworks. Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "concept_id": {
      "type": "string",
      "description": "Concept ID slug ('period-dutch-golden-age', 'movement-impressionism', 'iconography-lotus-purity') or full 'concept:...' ID."
    },
    "cross_tradition": {
      "description": "If true, also return concepts linked via hasFunctionalAnalog for cross-tradition analogy queries.",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Max linked artworks. Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "concept_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_influence_network

Cost: ~2-3s. N-hop influence BFS. Use ONLY when depth>1 needed — get_artist already has 1-hop.

Parameters3

seed_person_id	string	required	Seed artist — person ID slug or full 'person:...'.
max_depth	integer	optional	BFS depth. Default 2. Keep ≤3 unless needed — cost grows combinatorially.
direction	string	optional	outgoing = who the seed influenced; incoming = who influenced the seed; both = union.

Raw schema

{
  "type": "object",
  "properties": {
    "seed_person_id": {
      "type": "string",
      "description": "Seed artist — person ID slug or full 'person:...'."
    },
    "max_depth": {
      "default": 2,
      "description": "BFS depth. Default 2. Keep ≤3 unless needed — cost grows combinatorially.",
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "direction": {
      "default": "both",
      "description": "outgoing = who the seed influenced; incoming = who influenced the seed; both = union.",
      "type": "string",
      "enum": [
        "outgoing",
        "incoming",
        "both"
      ]
    }
  },
  "required": [
    "seed_person_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_reception_arc

Cost: ~1s. Time-ordered reception claims for artist or artwork. Use for valence-shift narrative. Use query_reception_price_correlation if you also need price.

Parameters2

artist_id	string	optional	Person ID slug or 'person:...'. Mutually exclusive with artwork_id.
artwork_id	string	optional	Artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "description": "Person ID slug or 'person:...'. Mutually exclusive with artwork_id.",
      "type": "string"
    },
    "artwork_id": {
      "description": "Artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_provenance_chain

Cost: ~1s. Custody timeline + gap-risk flags (Nazi, colonial, Russian Rev, Knoedler 1970-2009). Use only for deep due diligence — get_artwork already has basic custody.

Parameters3

artwork_id	string	required	Artwork ID slug or full 'artwork:...' ID.
period_start	integer	optional	Restrict chain to custody periods overlapping this year or later (e.g. 1933 for Nazi-era slice).
period_end	integer	optional	Restrict chain to custody periods overlapping this year or earlier (e.g. 1945).

Raw schema

{
  "type": "object",
  "properties": {
    "artwork_id": {
      "type": "string",
      "description": "Artwork ID slug or full 'artwork:...' ID."
    },
    "period_start": {
      "description": "Restrict chain to custody periods overlapping this year or later (e.g. 1933 for Nazi-era slice).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "period_end": {
      "description": "Restrict chain to custody periods overlapping this year or earlier (e.g. 1945).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "artwork_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_lineage_cluster

Cost: ~1s. Formal teacher/student cluster (education_lineage). Use for academic lineage. For conceptual influence: get_influence_network.

Parameters3

artist_id	string	required	Seed person ID slug or 'person:...'.
include_teachers	boolean	optional	Include people the seed studied under.
include_students	boolean	optional	Include people who studied under the seed.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Seed person ID slug or 'person:...'."
    },
    "include_teachers": {
      "default": true,
      "description": "Include people the seed studied under.",
      "type": "boolean"
    },
    "include_students": {
      "default": true,
      "description": "Include people who studied under the seed.",
      "type": "boolean"
    }
  },
  "required": [
    "artist_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_comparable_artworks

Cost: ~2s. Comparable set. EITHER artwork_id seed → similar works, OR artist_id seed → peer artists. Not for same-artist lot history (use search_auction_history).

Parameters8

artwork_id	string	optional	Seed artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.
artist_id	string	optional	Seed artist person ID slug or 'person:...'. Returns peer artists by era/polity/tradition overlap. Mutually exclusive with artwork_id.
iconographic_subject	string	optional	Optional subject keyword (artwork_seed mode only).
patron_class	string	optional	Patron class keyword (artwork_seed mode only).
medium_keyword	string	optional	Medium keyword (artwork_seed mode only).
period	string	optional	Period concept ID or keyword.
years_back	integer	optional	Lookback window from today, default 15.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "artwork_id": {
      "description": "Seed artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.",
      "type": "string"
    },
    "artist_id": {
      "description": "Seed artist person ID slug or 'person:...'. Returns peer artists by era/polity/tradition overlap. Mutually exclusive with artwork_id.",
      "type": "string"
    },
    "iconographic_subject": {
      "description": "Optional subject keyword (artwork_seed mode only).",
      "type": "string"
    },
    "patron_class": {
      "description": "Patron class keyword (artwork_seed mode only).",
      "type": "string"
    },
    "medium_keyword": {
      "description": "Medium keyword (artwork_seed mode only).",
      "type": "string"
    },
    "period": {
      "description": "Period concept ID or keyword.",
      "type": "string"
    },
    "years_back": {
      "default": 15,
      "description": "Lookback window from today, default 15.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_market_summary

Cost: ~2s. Per-artist market aggregates × reception × polity. Use for cross-artist comparison. Single artist deep profile: get_artist. Individual lots: search_auction_history.

Parameters6

artist_id	string	optional	Specific artist.
era	string	optional	Era substring (e.g. 'contemporary', 'modern').
polity	string	optional	Polity name substring (e.g. 'French Republic', 'Qing').
reception_register	string	optional	Filter by the artist's latest reception register.
min_price_usd	integer	optional	Min across max_usd_2024 → max_realized_price_usd → max_usd_nominal (whichever available).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "description": "Specific artist.",
      "type": "string"
    },
    "era": {
      "description": "Era substring (e.g. 'contemporary', 'modern').",
      "type": "string"
    },
    "polity": {
      "description": "Polity name substring (e.g. 'French Republic', 'Qing').",
      "type": "string"
    },
    "reception_register": {
      "description": "Filter by the artist's latest reception register.",
      "type": "string",
      "enum": [
        "hostile_contemporary",
        "ambivalent_contemporary",
        "rehabilitation",
        "canonical_elevation",
        "contested",
        "ignored",
        "rediscovered"
      ]
    },
    "min_price_usd": {
      "description": "Min across max_usd_2024 → max_realized_price_usd → max_usd_nominal (whichever available).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_polity_dispersal

Cost: ~2s. Polity-origin artworks now dispersed. Use for restitution/cultural-heritage analysis. For simple list: search_artworks.

Parameters3

polity_id	string	required	Polity ID slug or 'place:...' (e.g. 'benin-kingdom').
years_after_collapse	integer	optional	How many years after collapse to count as 'dispersal-adjacent'. Default 80 — Nazi-era (Third Reich, place:polity-nazi-germany) restitutions typically occur 50-70 years after 1945 (e.g. Klimt's Adele Bloch-Bauer restituted 2006), so a wide window is required to surface HEAR Act dispersal. Narrow to ~20 for tightly-coupled looting events.
rank_by_claim_priority	boolean	optional	If true, add claim_priority_score to each row (seizure=3, unknown=2, gift/bequest=1; +1 if within collapse window) and sort DESC. Repatriation advocate use case.

Raw schema

{
  "type": "object",
  "properties": {
    "polity_id": {
      "type": "string",
      "description": "Polity ID slug or 'place:...' (e.g. 'benin-kingdom')."
    },
    "years_after_collapse": {
      "default": 80,
      "description": "How many years after collapse to count as 'dispersal-adjacent'. Default 80 — Nazi-era (Third Reich, place:polity-nazi-germany) restitutions typically occur 50-70 years after 1945 (e.g. Klimt's Adele Bloch-Bauer restituted 2006), so a wide window is required to surface HEAR Act dispersal. Narrow to ~20 for tightly-coupled looting events.",
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    },
    "rank_by_claim_priority": {
      "description": "If true, add claim_priority_score to each row (seizure=3, unknown=2, gift/bequest=1; +1 if within collapse window) and sort DESC. Repatriation advocate use case.",
      "type": "boolean"
    }
  },
  "required": [
    "polity_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_exhibition_history

Cost: ~0.5s–1s. Exhibition history for an artist OR artwork. SINGLE CALL. Returns normalised exhibition records (exhibitions table) when available; falls back to knowledge-graph event nodes (raw_json scan) when the normalised table is empty. Coverage: 94 curated events for 20+ artists as of 2026-04-24. For artists with no data, returns actionable guidance including the exact CLI command to run artsy_exhibitions.py to ingest missing records. Always returns coverage_gaps and suggested_next_tools when data is sparse or absent.

Parameters2

artist_id	string	optional	Person ID slug or 'person:...'. Mutually exclusive with artwork_id.
artwork_id	string	optional	Artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "description": "Person ID slug or 'person:...'. Mutually exclusive with artwork_id.",
      "type": "string"
    },
    "artwork_id": {
      "description": "Artwork ID slug or 'artwork:...'. Mutually exclusive with artist_id.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_career_trajectory

Cost: ~2s. Artist career trajectory analysis: milestones, career stage, pattern detection (A–E), and comparable historical artists who followed the same path. Career stages: PRE_MARKET → REGIONAL → CRITICAL_PHASE → MARKET_ENTRY → ESTABLISHED. Patterns: A=institutional escalation, B=curator championing, C=movement anchor, D=late market discovery, E=diaspora rediscovery. Use for: emerging artist discovery, gallery acquisition decisions, curator narrative building. Do NOT use for purely biographical queries — use get_artist instead.

Parameters2

artist_id	string	required	Person ID slug or 'person:...'. Required.
include_comparables	boolean	optional	Whether to include historical comparable artists (default true). Set false to reduce latency.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Person ID slug or 'person:...'. Required."
    },
    "include_comparables": {
      "default": true,
      "description": "Whether to include historical comparable artists (default true). Set false to reduce latency.",
      "type": "boolean"
    }
  },
  "required": [
    "artist_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_reception_price_correlation

Cost: ~2s. Reception × price timeline for one artist. Combines get_reception_arc + price trend in one call.

Parameters1

artist_id

string

required

Person ID slug or 'person:...'.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Person ID slug or 'person:...'."
    }
  },
  "required": [
    "artist_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_career_patterns

Cost: ~4s. Side-by-side career trajectory comparison for two artists. Returns full trajectory data for each + a structured comparison: pattern overlap score, career stage delta, exhibition/market delta, interpretation, and recommendation. Use when: gallery wants to pitch an emerging artist by showing they mirror a validated comparable's early career. Use when: curator needs narrative evidence that artist A is at the same inflection point artist B was at in year X. Do NOT use when: you need data on one artist — use get_career_trajectory instead. Do NOT use when: you want to discover emerging artists — use find_emerging_artists_by_pattern instead.

Parameters2

artist_id_1	string	required	First artist — person ID slug or 'person:...'.
artist_id_2	string	required	Second artist — person ID slug or 'person:...'. Use a well-documented historical artist as the benchmark.

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id_1": {
      "type": "string",
      "description": "First artist — person ID slug or 'person:...'."
    },
    "artist_id_2": {
      "type": "string",
      "description": "Second artist — person ID slug or 'person:...'. Use a well-documented historical artist as the benchmark."
    }
  },
  "required": [
    "artist_id_1",
    "artist_id_2"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_emerging_artists_by_pattern

Cost: ~3s. Discover emerging artists whose current KG footprint matches a historical career pattern. Patterns: A=institutional_escalation, B=curator_championing, C=movement_anchor, D=late_market_discovery, E=diaspora_rediscovery. Returns ranked candidates with confidence score, exhibition/market data, and signal summary. Use when: gallery wants a shortlist of artists at an early inflection point matching a proven pattern. Use when: curator is building a thematic exhibition and wants artists at the right career stage. Use when: collector wants names not yet on the market radar. Do NOT use when: you already have a specific artist in mind — use get_career_trajectory instead. Do NOT use when: you want to compare two artists — use compare_career_patterns instead. Coverage note: results depend on exhibition data ingested; artists with no exhibition records won't appear.

Parameters4

pattern	string	required	Pattern to search: 'A_institutional_escalation', 'B_curator_championing', 'C_movement_anchor', 'D_late_market_discovery', or 'E_diaspora_rediscovery'. Single letter also accepted (e.g. 'A').
min_confidence	number	optional	Minimum confidence score (0–1). Default 0.35.
limit	number	optional	Max candidates to return (1–30). Default 10.
birth_year_after	number	optional	Filter to artists born after this year. Default varies by pattern.

Raw schema

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Pattern to search: 'A_institutional_escalation', 'B_curator_championing', 'C_movement_anchor', 'D_late_market_discovery', or 'E_diaspora_rediscovery'. Single letter also accepted (e.g. 'A')."
    },
    "min_confidence": {
      "default": 0.35,
      "description": "Minimum confidence score (0–1). Default 0.35.",
      "type": "number"
    },
    "limit": {
      "default": 10,
      "description": "Max candidates to return (1–30). Default 10.",
      "type": "number"
    },
    "birth_year_after": {
      "description": "Filter to artists born after this year. Default varies by pattern.",
      "type": "number"
    }
  },
  "required": [
    "pattern"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_galleries

Cost: ~1s. Search galleries by name, tier, country, or city. Tiers: mega (Gagosian/Zwirner level), major (international program), boutique (focused), emerging (newer). Use when: identifying which galleries operate in a specific market or tier band. Use when: building a B2B target list (galleries by region/tier). Do NOT use when: you want to know which gallery represents a specific artist — use find_galleries_by_artist instead.

Parameters5

query	string	optional	Free-text search across gallery name and id.
tier	string	optional
country	string	optional	ISO 2-letter code (e.g. 'US', 'GB', 'KR').
city	string	optional	City name (case-insensitive partial match).
limit	number	optional	Max results (1–100). Default 20.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search across gallery name and id.",
      "type": "string"
    },
    "tier": {
      "type": "string",
      "enum": [
        "mega",
        "major",
        "boutique",
        "emerging"
      ]
    },
    "country": {
      "description": "ISO 2-letter code (e.g. 'US', 'GB', 'KR').",
      "type": "string"
    },
    "city": {
      "description": "City name (case-insensitive partial match).",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Max results (1–100). Default 20.",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_gallery_artists

Cost: ~1s. Get the represented-artist roster for a specific gallery. Returns: gallery metadata + ordered list of artists with exclusivity (exclusive/shared/former/deceased_estate), period, notes. Use when: preparing pitch context for a specific gallery (cold email, fair planning). Use when: validating whether artist representation overlap exists between two galleries. Do NOT use when: you only have the artist name — use find_galleries_by_artist instead.

Parameters2

gallery_id	string	required	Gallery ID slug or 'gallery:...'. Required.
include_former	boolean	optional	Include former representations and deceased estates (default true).

Raw schema

{
  "type": "object",
  "properties": {
    "gallery_id": {
      "type": "string",
      "description": "Gallery ID slug or 'gallery:...'. Required."
    },
    "include_former": {
      "default": true,
      "description": "Include former representations and deceased estates (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "gallery_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_galleries_by_artist

Cost: ~1s. Find all galleries that represent (currently or formerly) a specific artist. Returns: ordered list of representations (current first, then deceased_estate, then former), with gallery tier/city/country and period. Use when: verifying primary-market representation for valuation or attribution context. Use when: building artist-centric outreach (which galleries control supply). Use when: tracking representation history for a deceased artist's estate.

Parameters2

artist_id	string	required	Person ID slug or 'person:...'. Required.
include_former	boolean	optional	Include former representations (default true).

Raw schema

{
  "type": "object",
  "properties": {
    "artist_id": {
      "type": "string",
      "description": "Person ID slug or 'person:...'. Required."
    },
    "include_former": {
      "default": true,
      "description": "Include former representations (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "artist_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

lookup_met_museum

Cost: ~0.3s. Search the Metropolitan Museum of Art collection (free public API · ~480K objects) and optionally dereference an objectID. Use when: you need a museum-confirmed match for an artist or work, or want to triangulate Provenio data against Met holdings. Returns either {total, objectIDs[]} for a search OR a full object record if object_id supplied. Source: https://collectionapi.metmuseum.org/public/collection/v1 · zero PII, public domain images flagged.

Parameters4

query	string	optional	Free-text search (artist, title, keyword). Required if object_id not given.
object_id	integer	optional	Met objectID for full record dereference.
has_images	boolean	optional	Filter to objects with images. Search-only.
limit	integer	optional	Max objectIDs to return (1-50).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search (artist, title, keyword). Required if object_id not given.",
      "type": "string"
    },
    "object_id": {
      "description": "Met objectID for full record dereference.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "has_images": {
      "default": true,
      "description": "Filter to objects with images. Search-only.",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "description": "Max objectIDs to return (1-50).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

lookup_europeana

Cost: ~0.5s. Search the Europeana cultural heritage corpus (~50M records from EU museums/archives) for art records. Use when: triangulating Provenio data against European museum holdings, or finding object records with images for a Western European artist. Returns: {total, items: [{title, creator, dataProvider, year, image_url, edm_url}]} Source: api.europeana.eu (public-domain Europe gateway, demo key embedded; users can supply own key via byok_external_query for high-volume).

Parameters2

query	string	required	Search query, e.g. 'pissarro paris 1897' or 'who:"Rembrandt"'
limit	integer	optional	Max records (1-50).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query, e.g. 'pissarro paris 1897' or 'who:\"Rembrandt\"'"
    },
    "limit": {
      "default": 10,
      "description": "Max records (1-50).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

lookup_wikidata_art

Cost: ~3-8s. Run a SPARQL query against Wikidata (public, no auth) for art-related entities. Use when: you need cross-museum location data for an artist's works, or biographical data not in Provenio. Pattern: pass a SPARQL query string. Example below to get all Klimt artworks with current location. Returns: {total, bindings: [...]} — raw SPARQL JSON results format. Source: https://query.wikidata.org/sparql · 12-second SPARQL query timeout enforced.

Parameters1

sparql

string

required

SPARQL SELECT query. Example for Klimt's artworks with location: SELECT ?artworkLabel ?locationLabel WHERE { ?artwork wdt:P170 wd:Q34661. ?artwork wdt:P276 ?location. SERVICE wikibase:label { bd:serviceParam wikibase:language "en". } } LIMIT 10

Raw schema

{
  "type": "object",
  "properties": {
    "sparql": {
      "type": "string",
      "description": "SPARQL SELECT query. Example for Klimt's artworks with location:\nSELECT ?artworkLabel ?locationLabel WHERE { ?artwork wdt:P170 wd:Q34661. ?artwork wdt:P276 ?location. SERVICE wikibase:label { bd:serviceParam wikibase:language \"en\". } } LIMIT 10"
    }
  },
  "required": [
    "sparql"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

byok_external_query

Cost: ~variable. Forward a JSON HTTP request to YOUR own external API endpoint and return the response. Use when: you need to query a third-party art-market source (Artnet/Artprice/your own gallery DB) that we do not host. Auth: pass your API key in MCP request header 'x-byok-auth' — we forward it as Authorization to your endpoint. Allowed hosts: must match an HTTPS URL on the public internet (no internal IPs, localhost, file://, etc). Returns: {status, body, headers, fetched_at, source_url} — body parsed if JSON, raw if not. Logged for your own audit trail; never trained on. We do NOT cache or persist response bodies.

Parameters4

endpoint_url	string	required	Full HTTPS URL of your external API. Required.
method	string	optional	HTTP method (GET or POST). Default GET.
body_json	object	optional	Optional JSON body for POST requests.
timeout_ms	number	optional	Per-request timeout in ms (max 20000).

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint_url": {
      "type": "string",
      "format": "uri",
      "description": "Full HTTPS URL of your external API. Required."
    },
    "method": {
      "default": "GET",
      "description": "HTTP method (GET or POST). Default GET.",
      "type": "string",
      "enum": [
        "GET",
        "POST"
      ]
    },
    "body_json": {
      "description": "Optional JSON body for POST requests.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "timeout_ms": {
      "default": 8000,
      "description": "Per-request timeout in ms (max 20000).",
      "type": "number"
    }
  },
  "required": [
    "endpoint_url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search

Search the Provenio art-provenance knowledge graph (artists + artworks) by free text. Returns a ranked list of {id, title, url}. Pass an id to `fetch` for the full record. Use this as the entry point for any name/title lookup. (ChatGPT connector entry tool — wraps search_artists + search_artworks.)

Parameters1

query

string

required

Free-text query — an artist name, artwork title, movement, or keyword.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text query — an artist name, artwork title, movement, or keyword."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch

Fetch the full Provenio record for an id returned by `search` (person:… or artwork:…). Returns {id, title, text, url, metadata} where text is a readable provenance/market/influence summary. (ChatGPT connector document-fetch tool — wraps get_artist / get_artwork.)

Parameters1

string

required

An id from search results, e.g. 'person:jacob-jordaens' or 'artwork:...'.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "An id from search results, e.g. 'person:jacob-jordaens' or 'artwork:...'."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (27)

search_artistssearch_artworkssearch_auction_historyget_artistget_artworkget_movement_contextget_influence_networkget_reception_arc

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://provenio.art/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "provenio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://provenio.art/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.