Repository avatar
AI Tools
v1.1.0
active

art-search

com.artsdot/art-search

Discover art by mood, colour or artist, and get the price of a canvas print or oil painting.

Documentation

WahooArt Art Search MCP

Give your AI assistant a fine art catalog, with live prices for reproductions.

Check the live server License: MIT Authentication: none Tools: read-only

Website · Server documentation · Tool reference

644,61552,8885,40619,44632
artworksartistsmuseumsarticleslanguages

Approved catalog rows on 4 November 2026. The catalog keeps growing.

WahooArt is a full-service art destination: oil reproductions hand-painted by trained painters on linen canvas, giclée prints, digital images, and custom paintings from your own photos. With this server, your assistant can search that catalog, read the details, check what is for sale now and quote a price.

The server runs on our side, so there is nothing to install or host. No account, no key, no OAuth, and it's free to use.

Quick start

Add this address to your assistant as a remote MCP server:

https://direct.wahooart.com/mcp/

Then ask, for example:

How much is a hand-painted oil copy of The Starry Night at 90 x 70 cm, framed, in euros?

Find me calm landscape paintings for a hotel lobby.

What would a 60 x 80 cm oil painting of my own photo cost?

Which oil paintings are in stock now, under 500 dollars?

Connect your client

Claude or ChatGPT: open the connector settings, add a custom connector, paste the address and leave the authentication empty.

Claude Code:

claude mcp add --transport http wahooart https://direct.wahooart.com/mcp/
Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "wahooart": {
      "url": "https://direct.wahooart.com/mcp/"
    }
  }
}
VS Code

In .vscode/mcp.json:

{
  "servers": {
    "wahooart": {
      "type": "http",
      "url": "https://direct.wahooart.com/mcp/"
    }
  }
}
Other clients

Copy .mcp.json, or enter these values:

SettingValue
TransportStreamable HTTP, JSON answers only
Addresshttps://direct.wahooart.com/mcp/
MethodPOST
AuthenticationNone

[!NOTE] Opening the address in a browser takes you to the server documentation. MCP clients send POST requests, and any other GET answers HTTP 405, which is normal. Keep the final slash, because without it the request is redirected and its body is lost.

Tools

All 14 tools are read-only. Each one takes an optional language parameter, English by default.

Search

You haveYou wantTool
A name or keywordsMatching artworks, artists, museums and articlessearch_fts
A name or keywordsOne kind of object, with its own filterssearch_artworks, search_artists, search_museums, search_articles
A questionThe passages of our texts that answer itsearch_sections_semantically
A textThe objects it is aboutsearch_objects_semantically

Details, prices and availability

ToolWhat it does
get_detail_artwork, get_detail_artist, get_detail_museum, get_detail_articleThe full data of one object, by the pk a search returned
get_quotationThe price of a print or a hand-painted oil reproduction of an artwork, at a given size and in a given currency, with an order link
get_custom_reproduction_quotationThe same price from size, type and currency alone, for your own image or an artwork the catalog does not have
get_artwork_availabilityWhether the artwork itself is for sale now (ready-made painting in stock, auction lot, original, collectible), with its price, or the list of objects for sale in one of those channels

The server cannot place an order, take a payment or change anything. It gives you links: you order and pay on the website, in your browser.

For every parameter, read TOOLS.md or call tools/list.

Call it from your own code

Try it from a terminal:

curl -s https://direct.wahooart.com/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_artworks","arguments":{"query":"Monet water lilies","limit":3}}}'

The examples folder holds the same small program in Python and JavaScript. It finds an artwork, reads its details and prices an oil reproduction. A run in Python on 4 November 2026 printed:

Vincent van Gogh, Starry Night Over the Rhone
https://wahooart.com/en/art/vincent-willem-van-gogh-starry-night-over-the-rhone-5ZKG45-en/
Luminous yellow reflections dance upon the dark water under a deep blue, swirling night sky.
Hand-painted oil painting, 87.7 x 71.9 cm, unframed, delivered rolled: 328 EUR — [Order](https://wahooart.com/en/art/vincent-willem-van-gogh-starry-night-over-the-rhone-5ZKG45-en/ArtistReproduction/?reproduction_medium=OilPainting&size_type=custom&size_unit=CM&size_width_cm=87.6698&size_height_cm=71.8605&frame=Rolled)

Good to know

  • Tool names: until November 2026 the two quotation tools were named get_a_quotation and get_a_custom_reproduction_quotation. The old names still answer.
  • Sizes: the quoted size follows the artwork's own proportions, and a size outside 25 to 250 cm per side is quoted at the nearest valid size. Read width_cm and height_cm in the answer, as the example above shows.
  • offer_text: every quotation carries this ready-made line with the type, size, price and order link. Show it to the user as it is, translating its words if needed but never changing its numbers or link.
  • Semantic search: it can answer index_unavailable. Use the full-text search tools in that case.
  • Rate limit: 30 requests per second per IP address, with short bursts of 20 more. Beyond that the server answers HTTP 429.

Your own orders

One more tool, get_my_orders_details, returns a customer's own orders and needs a personal token. WahooArt customers can copy theirs from their account. Treat it like a password, and keep it out of your code and your repository.

Privacy

The tools above read public catalog data only and ask for no name, account or key. For each tool call we record the tool name, the language, the website, the time, the client's user agent and a salted hash of its IP address. Your search words are not part of this record. Read the full notice.

Support

A question or a problem with the server? Write to Contact@WahooArt.com or open an issue.

License

The examples and files in this repository are under the MIT License. It does not cover the WahooArt catalog, its texts and images, or the server.

No installation packages available.

Remote