BrickLink MCP server for AI agents
Let Claude, ChatGPT or your own agent read BrickLink: 5 typed functions through one MCP server. No BrickLink API key needed.
- Site
- bricklink.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for BrickLink alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/bricklinkOne MCP server for BrickLink and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
categoriesList BrickLink's top-level LEGO catalogue categories (Sets, Parts, Minifigures, MOCs, …) with how many items each holds and its catalogue link.Arguments
None.
Returns
{ categories: BricklinkCategory[] }interface BricklinkCategory { name: string; itemCount: number | null; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bricklink/categoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bricklink.categories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bricklink.categories())curl -X POST https://api.bowmark.ai/v1/sites/bricklink/categories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bricklink.categories();imagesList the BrickLink catalogue images for one item in one colour: main and large image URLs plus thumbnails.Arguments
Name Type Required itemIdnumberYes colorIdnumberNo Returns
{ itemNo: string | null; name: string | null; images: BricklinkImage[] }interface BricklinkImage { /** "main" | "large" | other BrickLink codes */ kind: string | null; colorId: number | null; url: string | null; thumbUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bricklink/imagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bricklink.images({ itemId: 102706, colorId: 12 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bricklink.images({"itemId": 102706, "colorId": 12}))curl -X POST https://api.bowmark.ai/v1/sites/bricklink/images \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"itemId":102706,"colorId":12}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bricklink.images({ itemId: 102706, colorId: 12 });itemRead one BrickLink catalogue item (set, part, minifigure…) by its item number: name, category, year released, weight, stud and package dimensions…Arguments
Name Type Required argsstring | BricklinkItemArgsYes interface BricklinkItemArgs { /** e.g. "75192-1" (set) or "47543pb05" (part), or a catalogitem.page URL */ itemNo: string; /** default: "set" when itemNo looks like 1234-1, otherwise "part" */ type?: string; }Returns
BricklinkIteminterface BricklinkItem { itemId: number | null; type: string; typeName: string | null; itemNo: string; name: string | null; /** breadcrumb, e.g. ["Star Wars", "Ultimate Collector Series"] */ category: string[]; yearReleased: string | null; weight: string | null; studDimensions: string | null; packageDimensions: string | null; imageUrl: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bricklink/itemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bricklink.item({ itemNo: "75192-1", type: "set" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bricklink.item({"itemNo": "75192-1", "type": "set"}))curl -X POST https://api.bowmark.ai/v1/sites/bricklink/item \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"itemNo":"75192-1","type":"set"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bricklink.item({ itemNo: "75192-1", type: "set" });offersList the BrickLink marketplace stores selling one catalogue item in one colour: price, quantity, new or used, store name, seller feedback and…Arguments
Name Type Required itemIdnumberYes colorIdnumberBrickLink colour id; 0 (default) for sets and uncoloured items.No condition"new" | "used"No pagenumberNo perPagenumberNo Returns
{ total: number; page: number; offers: BricklinkOffer[] }interface BricklinkOffer { lotId: number | null; condition: "new" | "used" | null; completeness: string | null; description: string | null; quantity: number | null; color: string | null; /** in the caller's display currency */ price: string | null; /** in the store's own currency */ storePrice: string | null; salePercent: number | null; store: string | null; seller: string | null; sellerFeedback: number | null; sellerCountry: string | null; minBuy: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bricklink/offersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bricklink.offers({ itemId: 102706, colorId: 12, perPage: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bricklink.offers({"itemId": 102706, "colorId": 12, "perPage": 3}))curl -X POST https://api.bowmark.ai/v1/sites/bricklink/offers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"itemId":102706,"colorId":12,"perPage":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bricklink.offers({ itemId: 102706, colorId: 12, perPage: 3 });searchSearch the BrickLink LEGO catalogue for sets, parts, minifigures, gear and instructions by name or number; results are grouped by type with item…Arguments
Name Type Required argsstring | BricklinkSearchArgsYes interface BricklinkSearchArgs { query: string; /** "set" | "part" | "minifigure" | "book" | "gear" | "catalog" | "instructions" | "original box"; omit for all */ type?: string; page?: number; /** 1-100, default 25 */ perPage?: number; }Returns
{ groups: BricklinkSearchGroup[] }interface BricklinkSearchItem { /** BrickLink's internal id, pass to offers / images */ itemId: number | null; /** one-letter type, e.g. "S" */ type: string | null; typeName: string | null; /** catalogue number, e.g. "75192-1" or "3001" */ itemNo: string | null; name: string | null; newQty: number | null; newSellers: number | null; /** display price string in the currency BrickLink picked, e.g. "GBP 421.30"; null when nobody sells it */ newMinPrice: string | null; newMaxPrice: string | null; usedQty: number | null; usedSellers: number | null; usedMinPrice: string | null; usedMaxPrice: string | null; imageColorId: number | null; url: string | null; } interface BricklinkSearchGroup { type: string | null; typeName: string | null; /** total matches of this type across every page */ count: number | null; items: BricklinkSearchItem[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bricklink/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bricklink.search({ query: "millennium falcon", type: "set", perPage: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bricklink.search({"query": "millennium falcon", "type": "set", "perPage": 3}))curl -X POST https://api.bowmark.ai/v1/sites/bricklink/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"millennium falcon","type":"set","perPage":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bricklink.search({ query: "millennium falcon", type: "set", perPage: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bricklink/<function> - OpenAPI
/v1/sites/bricklink/openapi.json