MCP server

For agents

obbjects is an MCP server. Add it to your agent and ask for things like “find a coffee mug on white for my slide”. The agent gets an image URL, license and attribution back.

Endpoint

https://obbjects.com/api/mcp

Claude Code

claude mcp add --transport http obbjects https://obbjects.com/api/mcp

Clients that use a JSON config

{
  "mcpServers": {
    "obbjects": {
      "url": "https://obbjects.com/api/mcp"
    }
  }
}

Tools

search_objects
Find objects by words, category or color. Returns image URLs.
get_object
Get one object by id.
list_categories
See which categories exist.

What your agent gets back

One object from search_objects, live from the catalog. Agents should keep attribution with the image wherever the license asks for credit.

{
  "id": "glass-teapot-d3463c",
  "name": "Glass teapot",
  "description": "Round glass teapot with a stainless steel cradle, lid and mesh tea infuser.",
  "category": "kitchen",
  "tags": [
    "teapot",
    "glass teapot",
    "infuser",
    "tea",
    "stainless steel",
    "kitchen",
    "tableware"
  ],
  "color": "silver",
  "license": "PDM-1.0",
  "attribution": "Photo: Jorge Barrios, Public domain (creativecommons.org/publicdomain/mark/1.0), via Wikimedia Commons, commons.wikimedia.org/wiki/File:TeaPot.jpg. Background removed and recentered by obbjects.",
  "author": "Jorge Barrios",
  "source": "cc0",
  "source_name": "Wikimedia Commons",
  "source_url": "https://commons.wikimedia.org/wiki/File:TeaPot.jpg",
  "image_url": "https://obbjects.com/objects/glass-teapot-d3463c/full.webp",
  "png_url": "https://obbjects.com/objects/glass-teapot-d3463c/full.png",
  "thumbnail_url": "https://obbjects.com/objects/glass-teapot-d3463c/thumb-512.webp",
  "page_url": "https://obbjects.com/o/glass-teapot-d3463c",
  "size_px": 1024,
  "background": "white"
}

Loading example…

Plain HTTP

curl "https://obbjects.com/api/objects?q=mug"