Skip to content
Eden Engine

Met Museum Object Record (One Artwork by ID)

metmuseum/object

One object from The Metropolitan Museum of Art's collection by its object ID: title, artist and makers, date (the Museum's text plus signed begin and end years, BCE negative), medium, dimensions, department, classification, credit line, geography, subject tags with Getty AAT and Wikidata links, gallery, and the object's page on metmuseum.org. Image URLs (full size, web size, extra views) are returned only when isPublicDomain is true; for every other object they are empty and rightsAndReproduction carries the copyright line. Empty text fields are empty strings; constituents, measurements and tags are null when empty. Some dates are placeholders: 0 and 0 means undated, and a begin can be later than its end. Get ids from the Met Museum Collection Search tool; a few of its ids are not served here. Data from The Metropolitan Museum of Art, released under Creative Commons Zero. Served by Eden Engine; not endorsed by the Museum.

activeper callv2

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

The Metropolitan Museum of Art

Data from The Metropolitan Museum of Art, released under Creative Commons Zero (CC0) at github.com/metmuseum/openaccess. Image URLs are returned only for public-domain objects. Served by Eden Engine; not an official Metropolitan Museum of Art product and not endorsed by the Museum.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "metmuseum/object" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "metmuseum/object" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "metmuseum/object", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "metmuseum/object", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "object_id"
  ],
  "properties": {
    "object_id": {
      "type": "integer",
      "maximum": 99999999,
      "minimum": 1,
      "description": "The Met's object ID, for example 436535 (Van Gogh, Wheat Field with Cypresses). Ids come from the search tool; they are not accession numbers."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "objectID",
    "isPublicDomain"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City where made or found; often empty."
    },
    "tags": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Subject keywords, each with term, AAT_URL and Wikidata_URL. null when the object has none."
    },
    "locus": {
      "type": "string",
      "description": "Locus within a site; often empty."
    },
    "reign": {
      "type": "string",
      "description": "Reign. Often empty."
    },
    "river": {
      "type": "string",
      "description": "River associated with the origin; often empty."
    },
    "state": {
      "type": "string",
      "description": "State or province; often empty."
    },
    "title": {
      "type": "string",
      "description": "The title. Empty on about 5.5% of objects."
    },
    "county": {
      "type": "string",
      "description": "County; often empty."
    },
    "locale": {
      "type": "string",
      "description": "Locale; often empty."
    },
    "medium": {
      "type": "string",
      "description": "Materials, for example Oil on canvas."
    },
    "period": {
      "type": "string",
      "description": "Period. Often empty."
    },
    "region": {
      "type": "string",
      "description": "Region within the country; often empty."
    },
    "country": {
      "type": "string",
      "description": "Country where made or found; often empty."
    },
    "culture": {
      "type": "string",
      "description": "Culture of origin. Empty when unknown."
    },
    "dynasty": {
      "type": "string",
      "description": "Dynasty. Often empty."
    },
    "objectID": {
      "type": "integer",
      "description": "The object's id; unique, the key to use."
    },
    "objectURL": {
      "type": "string",
      "description": "The object's page on metmuseum.org."
    },
    "portfolio": {
      "type": "string",
      "description": "Portfolio or series the object belongs to."
    },
    "subregion": {
      "type": "string",
      "description": "Subregion; often empty."
    },
    "artistRole": {
      "type": "string",
      "description": "Role of the first constituent, for example Artist."
    },
    "creditLine": {
      "type": "string",
      "description": "How the object came to the Museum, for example Purchase, The Annenberg Foundation Gift, 1993."
    },
    "department": {
      "type": "string",
      "description": "The Museum's department name on this object. May differ in wording from the search tool's department list."
    },
    "dimensions": {
      "type": "string",
      "description": "Size as free text, usually inches then centimetres (\"28 13/16 x 36 3/4 in. (73.2 x 93.4 cm)\"). Empty on about 14% of objects."
    },
    "excavation": {
      "type": "string",
      "description": "Excavation name and years; often empty."
    },
    "objectDate": {
      "type": "string",
      "description": "The Museum's date as text (\"1889\", \"19th century\", \"ca. 1802-1550 B.C.\"). Empty on about 2.5% of objects."
    },
    "objectName": {
      "type": "string",
      "description": "The kind of object, for example Painting, Vase, Necktie."
    },
    "repository": {
      "type": "string",
      "description": "Always Metropolitan Museum of Art, New York, NY."
    },
    "isHighlight": {
      "type": "boolean",
      "description": "True for a work the Museum designates a highlight of its collection."
    },
    "artistGender": {
      "type": "string",
      "description": "Gender of the first maker; often empty."
    },
    "artistPrefix": {
      "type": "string",
      "description": "Prefix to the first maker's name."
    },
    "artistSuffix": {
      "type": "string",
      "description": "Suffix to the first maker's name."
    },
    "constituents": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Every maker, with id, role, name, Getty ULAN and Wikidata links and gender. null, not [], when the Museum lists none. The artist fields below describe only the first."
    },
    "linkResource": {
      "type": "string",
      "description": "Documented as a URL, empty on every record sampled. Use objectURL."
    },
    "measurements": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Measured elements, each with elementName, elementDescription and elementMeasurements (Height, Width, Depth, Diameter...) in centimetres; weights in kilograms. null when none."
    },
    "metadataDate": {
      "type": "string",
      "description": "When the record was last updated, ISO 8601 UTC."
    },
    "primaryImage": {
      "type": "string",
      "description": "URL of the full-size JPEG on images.metmuseum.org. Empty unless isPublicDomain is true, and empty on some public-domain objects the Museum has no image of."
    },
    "GalleryNumber": {
      "type": "string",
      "description": "Gallery the object is in; empty when it is not on view (about 91% are not)."
    },
    "accessionYear": {
      "type": "string",
      "description": "Year acquired, as text. Empty on about 0.8% of objects and a full date such as 1938-09-17 on a few."
    },
    "artistEndDate": {
      "type": "string",
      "description": "Death year of the first maker as text; empty when unknown."
    },
    "geographyType": {
      "type": "string",
      "description": "How the place relates to the object (\"Made in\", \"From\", \"Attributed to\")."
    },
    "objectEndDate": {
      "type": "integer",
      "description": "End year, signed, BCE negative. 9999 marks an ongoing work. See objectBeginDate for the placeholders."
    },
    "artistULAN_URL": {
      "type": "string",
      "description": "Getty ULAN page of the first maker."
    },
    "classification": {
      "type": "string",
      "description": "General type, for example Paintings, Ceramics, Prints. Empty on some objects."
    },
    "isPublicDomain": {
      "type": "boolean",
      "description": "True when the object is in the public domain (about 52% are). Image URLs are returned only when this is true."
    },
    "isTimelineWork": {
      "type": "boolean",
      "description": "True when the object appears in the Museum's Timeline of Art History."
    },
    "accessionNumber": {
      "type": "string",
      "description": "The Museum's accession number, for example 1993.132. Not always unique."
    },
    "artistAlphaSort": {
      "type": "string",
      "description": "The first maker's name in sort order."
    },
    "artistBeginDate": {
      "type": "string",
      "description": "Birth year of the first maker as text; empty when unknown."
    },
    "objectBeginDate": {
      "type": "integer",
      "description": "Start year, signed, BCE negative. 0 together with objectEndDate 0 means undated, not the year 0. Can be later than objectEndDate (142 objects)."
    },
    "additionalImages": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs of further views. [] under the same conditions as primaryImage."
    },
    "artistDisplayBio": {
      "type": "string",
      "description": "Nationality, places and years of the first maker as text."
    },
    "artistDisplayName": {
      "type": "string",
      "description": "Name of the FIRST maker only; empty when none. See constituents for the rest."
    },
    "artistNationality": {
      "type": "string",
      "description": "Nationality of the first maker."
    },
    "primaryImageSmall": {
      "type": "string",
      "description": "URL of the web-size JPEG. Empty under the same conditions as primaryImage."
    },
    "artistWikidata_URL": {
      "type": "string",
      "description": "Wikidata page of the first maker."
    },
    "objectWikidata_URL": {
      "type": "string",
      "description": "Wikidata page of the object; often empty."
    },
    "rightsAndReproduction": {
      "type": "string",
      "description": "The copyright line for an object still in copyright. Empty on public-domain objects and on most others."
    }
  },
  "description": "The Museum's object record, unmodified. Text fields are empty strings when the Museum has nothing; constituents, measurements and tags are null when empty.",
  "additionalProperties": true
}