`search_artworks`

Pack: artic · Endpoint: https://gateway.pipeworx.io/artic/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_artworks for the schema, then POST the same URL with its arguments for the data.

Search the Art Institute of Chicago collection by keyword. Returns artwork titles, artists, dates, mediums, and image IDs. Use get_artwork to fetch full details.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (e.g., “monet water lilies”)
`limit`	number	no	Number of results to return (1-100, default 10)

Example call

Arguments

{
  "query": "monet water lilies"
}

curl

curl -X POST https://gateway.pipeworx.io/artic/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_artworks","arguments":{"query":"monet water lilies"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_artworks', {
  "query": "monet water lilies"
});

More examples

{
  "query": "american portrait",
  "limit": 25
}

Response shape

Always returns: total, artworks

Field	Type	Description
`total`	number	Total number of artworks matching the search query
`artworks`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of artworks matching the search query"
    },
    "artworks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Artwork ID"
          },
          "title": {
            "type": "string",
            "description": "Artwork title"
          },
          "artist": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artist display name"
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date of creation"
          },
          "medium": {
            "type": [
              "string",
              "null"
            ],
            "description": "Medium used (e.g., oil on canvas)"
          },
          "image_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "ARTIC image identifier"
          },
          "image_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to high-resolution image"
          }
        },
        "required": [
          "id",
          "title"
        ]
      }
    }
  },
  "required": [
    "total",
    "artworks"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "artic": {
      "url": "https://gateway.pipeworx.io/artic/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_artworks