Agentbrush

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/agentbrush-dev-mcp-server

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

3 read · 5 write · 1 delete · 3 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (12)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• agentbrush_check_status

  Check AgentBrush authentication status, plan details, and token balance. Returns: authentication state, plan name, token balance, monthly allocation, cycle reset date, and quota state. Requires authentication (credentials must exist from a prior agentbrush_login). If not authenticated, returns a suggestion to run agentbrush_login. Call this before agentbrush_generate if you need to confirm the user has enough tokens for a generation. The response includes a human-readable summary you can relay directly to the user, including how many generations they can afford. Handles gracefully: missing c…

• agentbrush_edit_mask

  Open a browser-based mask editor for spatial precision edits on an existing image, then block until the user accepts a result. Use this instead of agentbrush_generate when the change requires repositioning, area-specific modifications, removing or adding elements in a specific region, or any edit that text prompts alone cannot express. How it works: 1. The tool opens a browser tab where the user draws a mask over the area to modify. 2. The user describes the change and submits the edit. 3. The tool blocks while the user edits (up to 30 minutes). 4. Returns the edited image path, token cost, a…

• agentbrush_edit_mask_open

  Open a mask editor session and return the editor URL immediately, without blocking. Prefer agentbrush_edit_mask for most cases — it blocks and returns the edited image automatically when the user accepts. Use this non-blocking variant only if you must keep working while the user draws. IMPORTANT: the edited image is NOT delivered to you until you call agentbrush_edit_mask_result with the returned session_id. Call it right after handing over the URL so the result is retrieved as soon as the user finishes (it keeps polling until they Accept and Finish). The tool best-effort opens the system def…

• agentbrush_edit_mask_result

  Block until the mask editor session reaches "completed" (the user accepted a result), then download and save the edited image. Pair with agentbrush_edit_mask_open. Blocks for up to 30 minutes (matching the signed editor URL lifetime); returns immediately when the user accepts. session_id is the UUID returned by agentbrush_edit_mask_open. image_path is optional. Pass the same path you handed to _open so the result is saved alongside it; otherwise the saved file lands in the current working directory.

• agentbrush_generate
• agentbrush_init

  Initialize AgentBrush in a project. Creates .agentbrush/ directory with: - identity.json: brand identity stub (style descriptor, color palette, mood tags) - references/: folder for reference images Non-destructive: skips files that already exist. Call this once per project before using brand identity features. This scaffolds project files only; it does not authenticate. Use the agentbrush_login tool (or run `agentbrush-mcp init` in a terminal) to connect an account.

• agentbrush_list_presets

  List all available AgentBrush image generation presets. Returns preset IDs, display names, pipeline types, word budgets, and features. No authentication required. Call this before agentbrush_generate if unsure which preset to use. Each preset has a unique visual style. The "realistic" preset uses the gpt-image-2 single-shot path (formerly a two-model pipeline). All other presets are single-model. Token cost is determined by quality_hint (low=1 / medium=5 / high=20 tokens at 1024×1024, multiplied by a resolution factor), not by preset. The response includes enough detail for you to recommend …

• agentbrush_list_references

  Browse reference images available in the project brand identity folder (.agentbrush/references/). Returns a list of image files with their filenames, tags, descriptions, and absolute paths, merged from identity.json.references[] manifest entries and any additional image files found on disk. Call this before agentbrush_generate when the user mentions a style, brand, or visual reference, so you can pick the most relevant images to include in the generation request. Optional tags parameter filters by tag (OR semantics, case-insensitive): { tags: ["hero", "logo"] } returns entries tagged with ei…

• agentbrush_login

  Authenticate this CLI with your AgentBrush account using device authorization. Opens a browser window where you approve the connection. After approval, API credentials are saved locally and persist across sessions. Only needs to be called once. Call this if agentbrush_check_status reports unauthenticated, or if agentbrush_generate fails with an authentication error. If already authenticated with a valid key, returns the current plan and token balance without starting a new auth flow. The tool blocks while waiting for browser approval (up to 15 minutes). No input parameters required.

• agentbrush_populate_identity
• agentbrush_remove_background

  Strip the background from a PNG/JPG/WebP and return a transparent PNG. Runs locally — no token charge. Typical use: generate an image with background: 'opaque', then call agentbrush_remove_background on the saved file. image_path must be an absolute path to an existing PNG/JPG/WebP file. output_dir is optional — defaults to the same directory as the source image. Returns the absolute path of the new PNG with a transparent background.

• agentbrush_save_as_reference

  Promote a previously-generated or mask-edited image into the project brand identity folder (.agentbrush/references/) and register it in identity.json so the agent can reuse it as a style/character reference on future agentbrush_generate calls. Typical workflow: generate a character with agentbrush_generate → optionally polish it via agentbrush_edit_mask → call agentbrush_save_as_reference with the saved file path → now every agentbrush_generate call can pass that reference path via reference_image_paths to keep the character consistent across new scenes. image_path must be an absolute path t…

Signals

Weekly downloads

21

Last release

Jun 25, 2026 (4 months ago)

Last package publish

Jun 25, 2026 (4 months ago)

From the package registry.

Details

Registry name

dev.agentbrush/mcp-server

Version

1.1.1

Auth

No auth

Packages

npm @agentbrush/mcp-server

License

License unknown

Website

agentbrush.dev

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registry