Local-first miniature-paint inventory and cross-brand color matching for AI agents.
Local-first miniature-paint inventory and cross-brand color matching for AI agents. That is what the minipainter mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
minipainter is a local-first paint registry for miniature-painting workflows. It exists for one practical reason: AI paint suggestions are much more useful when they understand the paints you actually own.
The server publishes 14 tools. What each one is for:
owned — first paint lookup and cross-brand color matchingOwned — first matching: lookups and recommendations can prioritize paints you already haveRGB — aware search: approximate RGB values help with nearest-color matchingAgent — friendly CLI: deterministic command output for AI integration (Claude + ChatGPT MCP)POSIX — ish shell (Linux, macOS, WSL)Self — hosted HTTP server** — a single Docker-friendly runtime with JSON storage and API endpointstoggle — quitimage — driven inventory fill from paint bottle photosmodel — photo analysis that recommends owned paints firstBuilt — in catalog data lives in data/catalog/ (Citadel and Army Painter, kept in version control)paint_search — paint_showinventory_list — inventory_mark_ownedBecause this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
Configuration is passed through the environment: INVENTORY_SYNC_TOKEN, PORT, INVENTORY_PATH, DATABASE_URL, AUTH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
This sits in the cloud and infrastructure group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Minipainter's toolset — owned, Owned, RGB and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ArturSkowronski; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| owned | first paint lookup and cross-brand color matching |
| Owned | first matching: lookups and recommendations can prioritize paints you already have. |
| RGB | aware search: approximate RGB values help with nearest-color matching. |
| Agent | friendly CLI: deterministic command output for AI integration (Claude + ChatGPT MCP). |
| POSIX | ish shell (Linux, macOS, WSL) |
| Self | hosted HTTP server** — a single Docker-friendly runtime with JSON storage and API endpoints |
| toggle | quit |
| image | driven inventory fill from paint bottle photos |
| model | photo analysis that recommends owned paints first |
| Built | in catalog data lives in data/catalog/ (Citadel and Army Painter, kept in version control) |
| paint_search | paint_show |
| inventory_list | inventory_mark_owned |
| inventory_mark_unowned | match_color |
| PORT | listen port, defaults to 3000 |
{
"mcpServers": {
"minipainter": {
"command": "npx",
"args": ["-y", "minipainter"],
"env": {
"INVENTORY_SYNC_TOKEN": "your-value",
"PORT": "your-value",
"INVENTORY_PATH": "your-value",
"DATABASE_URL": "your-value",
"AUTH_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| INVENTORY_SYNC_TOKEN | Credential the server authenticates with. | Yes |
| PORT | Configuration value read at startup. | Optional |
| INVENTORY_PATH | Filesystem location the server is allowed to use. | Optional |
| DATABASE_URL | Endpoint or connection string the server talks to. | Yes |
| AUTH_TOKEN | Credential the server authenticates with. | Yes |
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.
AWS Labs' official server suite — current AWS docs, CDK guidance, cost analysis and service tools.
Cloud browsers for AI agents — automation sessions that run in Browserbase's fleet, not on your machine.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Dashboards, Prometheus and Loki queries, incidents and alerts — observability by conversation.