How do I install the minipainter mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `INVENTORY_SYNC_TOKEN`, `PORT`, `INVENTORY_PATH`, `DATABASE_URL`, `AUTH_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Minipainter MCP Server

Local-first miniature-paint inventory and cross-brand color matching for AI agents.

Remote serverstreamable-http

What is the Minipainter MCP Server?

Local-first miniature-paint inventory and cross-brand color matching for AI agents.

The short version

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.

keep a local record of what is in your paint rack
search it quickly by name, role, family, and approximate color
prepare a stable inventory foundation for a future AI skill that can inspect links, photos, and model images

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
owned	first paint lookup and cross-brand color matching
toggle	quit
image	driven inventory fill from paint bottle photos
model	photo analysis that recommends owned paints first
paint_search	paint_show
inventory_list	inventory_mark_owned
inventory_mark_unowned	match_color

How to install the Minipainter MCP Server

{
  "mcpServers": {
    "minipainter": {
      "command": "node",
      "args": [
        "/absolute/path/to/minipainter/src/mcp-server.mjs"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

“Use Minipainter to owned.”
“Use Minipainter to Owned.”
“Use Minipainter to RGB.”

Frequently asked questions

Local-first miniature-paint inventory and cross-brand color matching for AI agents. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.