Install
$ agentstack add mcp-nazarlysyi-brickscope ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Brickscope
Identify LEGO parts, sets, and minifigures from images — as a CLI tool or an MCP server for AI assistants.
Powered by the Brickognize API and Rebrickable.
Huge thanks to Piotr Rybak for creating the Brickognize service and making LEGO recognition accessible to everyone!
CLI
npm install -g brickscope
brickscope identify photo.jpg --type part
brickscope part 3001 --color Black
brickscope set 75192
brickscope minifig fig-012805
Or run without installing: npx brickscope identify photo.jpg
[Full CLI documentation](./docs/cli.md)
MCP Server
For AI assistants (Claude, Cursor, etc.), add to your MCP config:
{
"mcpServers": {
"brickscope": {
"command": "npx",
"args": ["-y", "brickscope", "mcp"],
"env": {
"REBRICKABLE_API_KEY": "your-key-here",
"BRICKOGNIZE_CACHE": "sqlite"
}
}
}
}
[Full MCP documentation](./docs/mcp.md)
Configuration
Config file (CLI)
brickscope config init
Creates ~/.config/brickscope/config.json with your Rebrickable API key and cache settings.
Environment variables
| Variable | Default | Description | | --------------------- | ------- | ------------------------------------------------------------------------------------------------- | | REBRICKABLE_API_KEY | — | Free API key from rebrickable.com/api. Required for lookup tools. | | BRICKOGNIZE_CACHE | none | Cache mode: none, memory, or sqlite |
Environment variables take priority over the config file.
Features
- Image recognition — identify parts, sets, minifigures, and stickers from photos
- Batch processing — identify multiple images in parallel
- Part lookup — colors, set appearances via Rebrickable
- Set inventory — full parts list, year, theme, piece count
- Minifigure lookup — details and set appearances
- Caching — in-memory or SQLite cache for Rebrickable API responses
- Config file — save API key and preferences once, use everywhere
Examples
See the [examples](./examples) folder for prompt templates.
Development
npm install
npm run build
npm run dev # Watch mode
npm test # Unit + integration tests
npm run lint # ESLint
npm run format # Prettier
License
MIT
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: NazarLysyi
- Source: NazarLysyi/brickscope
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.