Skip to main content
Glama
BlockRunAI

BlockRun MCP

Official
by BlockRunAI
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

blockrun_image

Generate or edit AI images from text prompts or existing images, paying automatically with USDC on Base or Solana—no API keys needed.

Instructions

Generate or edit images via BlockRun. Pays with USDC on the ACTIVE chain — Base or Solana (see blockrun_wallet) — no separate API keys needed.

Actions:

  • generate (default): Create image from text prompt

  • edit: Transform an existing image using img2img

Generation models (1024x1024 base price; larger sizes cost more on gpt-image-*):

  • openai/gpt-image-2 ($0.06–0.12) — flagship, reasoning-driven, multilingual on-image text + character consistency (default)

  • openai/gpt-image-1 ($0.02–0.04) — GPT native image generation

  • google/nano-banana ($0.05) — Gemini-family image model

  • google/nano-banana-2 ($0.09) — Gemini 3.1 Flash, pro-level quality at Flash speed (1024x1024 only)

  • google/nano-banana-pro ($0.10; $0.15 at 4096px) — up to 4K, strongest photorealism

  • xai/grok-imagine-image ($0.02) — stylized, fast

  • xai/grok-imagine-image-pro ($0.07) — higher quality Grok Imagine

  • zai/cogview-4 ($0.015) — cheapest, photorealistic detailed scenes

  • bytedance/seedream-5-pro ($0.045; $0.09 when both dimensions exceed 1024) — Seedream 5.0 Pro; cheap widescreen at 1280x720 / 2048x1024, large formats up to 2848x1600

Edit (img2img) models: openai/gpt-image-2 (default), openai/gpt-image-1, google/nano-banana, google/nano-banana-2, google/nano-banana-pro Multi-image edit: pass an array of 2–4 source images to "image" to fuse them in one render (openai/* up to 4, google/* up to 3) — e.g. a subject plus a sprite layout guide, or a reference plus a brand logo. Source images and masks accept a base64 data URI, an http(s) URL, or a local file path (auto-encoded). Inpaint mask (openai/gpt-image-* only) via "mask"; not combinable with multiple source images.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
maskNoInpaint mask for edit action (openai/gpt-image-* only): a base64 data URI, http(s) URL, or local file path. Transparent areas of the mask are regenerated. Cannot be combined with multiple source images.
sizeNoImage size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro), 1280x720 / 2048x1024 / 2048x2048 / 2848x1600 (seedream-5-pro)1024x1024
imageNoSource image(s) for edit action: a base64 data URI, an http(s) URL, or a local file path (auto-encoded to a data URI) — or an array of 2–4 to fuse into one render (e.g. subject + layout guide, or reference + brand logo). openai/* accepts up to 4, google/* up to 3; a mask cannot be combined with multiple images.
modelNoModel to use (default: openai/gpt-image-2 for both generate and edit). gpt-image-2 renders on-image text best; nano-banana-pro for 4K photorealism; cogview-4 / grok-imagine-image for cheap drafts.
actionNogenerate: create from text; edit: transform existing imagegenerate
inlineNoReturn a small inline image preview (thumbnail) the client can render in-conversation, in addition to the full-resolution URL. Defaults to the BLOCKRUN_INLINE_IMAGES env setting (off unless set). Rich clients (e.g. the VS Code extension) render it; plain terminals ignore it. Off keeps responses lightweight.
promptYesImage description or edit instructions
qualityNostandard
agent_idNoAgent identifier for budget tracking and enforcement.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changedv0.45.1
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
  2. Changed2 schema fields changedv0.37.1
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "zai/cogview-4",
-  "google/nano-banana",
-  "google/nano-banana-pro",
-  "openai/gpt-image-1",
-  "openai/gpt-image-2",
-  "xai/grok-imagine-image",
-  "xai/grok-imagine-image-pro"
-]New value: +[
+  "zai/cogview-4",
+  "google/nano-banana",
+  "google/nano-banana-2",
+  "google/nano-banana-pro",
+  "openai/gpt-image-1",
+  "openai/gpt-image-2",
+  "xai/grok-imagine-image",
+  "xai/grok-imagine-image-pro",
+  "bytedance/seedream-5-pro"
+]
    • changedInput schema / properties / size / description
      Previous value: -"Image size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro)"New value: +"Image size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro), 1280x720 / 2048x1024 / 2048x2048 / 2848x1600 (seedream-5-pro)"
  3. Changed5 schema fields changedv0.25.2
    • addedInput schema / properties / image / anyOf
      Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "items": {
+      "type": "string"
+    },
+    "maxItems": 4,
+    "minItems": 1,
+    "type": "array"
+  }
+]
    • changedInput schema / properties / image / description
      Previous value: -"Source image for edit action: base64-encoded image or URL"New value: +"Source image(s) for edit action: a base64 data URI, an http(s) URL, or a local file path (auto-encoded to a data URI) — or an array of 2–4 to fuse into one render (e.g. subject + layout guide, or reference + brand logo). openai/* accepts up to 4, google/* up to 3; a mask cannot be combined with multiple images."
    • removedInput schema / properties / image / type
      Removed value: -"string"
    • addedInput schema / properties / inline
      Added value: +{
+  "description": "Return a small inline image preview (thumbnail) the client can render in-conversation, in addition to the full-resolution URL. Defaults to the BLOCKRUN_INLINE_IMAGES env setting (off unless set). Rich clients (e.g. the VS Code extension) render it; plain terminals ignore it. Off keeps responses lightweight.",
+  "type": "boolean"
+}
    • addedInput schema / properties / mask
      Added value: +{
+  "description": "Inpaint mask for edit action (openai/gpt-image-* only): a base64 data URI, http(s) URL, or local file path. Transparent areas of the mask are regenerated. Cannot be combined with multiple source images.",
+  "type": "string"
+}
  4. Changed4 schema fields changedv0.22.0
    • changedInput schema / properties / model / description
      Previous value: -"Model to use (default: dall-e-3 for generate, gpt-image-2 for edit). xai/grok-imagine-image is stylized and fast; xai/grok-imagine-image-pro is higher quality; gpt-image-2 is the newest edit-capable model with stronger instruction following."New value: +"Model to use (default: openai/gpt-image-2 for both generate and edit). gpt-image-2 renders on-image text best; nano-banana-pro for 4K photorealism; cogview-4 / grok-imagine-image for cheap drafts."
    • changedInput schema / properties / model / enum
      Previous value: -[
-  "zai/cogview-4",
-  "openai/dall-e-3",
-  "together/flux-schnell",
-  "google/nano-banana",
-  "openai/gpt-image-1",
-  "openai/gpt-image-2",
-  "xai/grok-imagine-image",
-  "xai/grok-imagine-image-pro"
-]New value: +[
+  "zai/cogview-4",
+  "google/nano-banana",
+  "google/nano-banana-pro",
+  "openai/gpt-image-1",
+  "openai/gpt-image-2",
+  "xai/grok-imagine-image",
+  "xai/grok-imagine-image-pro"
+]
    • addedInput schema / properties / size / description
      Added value: +"Image size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro)"
    • removedInput schema / properties / size / enum
      Removed value: -[
-  "1024x1024",
-  "1792x1024",
-  "1024x1792"
-]
  5. First observedv0.16.2

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With all annotation hints false, the description supplies the real behavioral burden: costs USDC on the active chain, requires no API key, supports specific input formats/array constraints, and exposes per-model price and capability differences. It also discloses the inline-preview env default and limitation that masks are openai/gpt-image-* only and exclude multiple source images.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but effectively structured: front-loaded action summary, then actions, then models, then input-format constraints. Some details such as mask/source-image formats repeat the schema, so it is not maximally concise, but every large block adds non-obvious information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's nine parameters and no output schema, the description covers almost everything an agent needs before invoking: payment, model selection, input formats, multi-image limits, size constraints, and inline preview behavior. It routes chain/wallet setup to blockrun_wallet, leaving no critical parameter or action unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is high, yet the description goes well beyond it by attaching prices, quality tiers, and recommended use cases to each model and by clarifying size/model compatibility and multi-image rules. This materially improves parameter choice for prompt, model, action, image, mask, size, and inline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly identifies the tool as image generation/editing via BlockRun, with distinct 'generate' and 'edit' actions and a concrete resource. The first sentence tells the agent exactly what it does, so it cannot be confused with image-unrelated siblings like blockrun_music or blockrun_video.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Descriptions of the default action, edit action, and model trade-offs give concrete selection guidance. It names blockrun_wallet for payment/chain context and lists model-specific use cases such as 'renders on-image text best' and 'for 4K photorealism', though it does not spell out 'use X instead of this tool' exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BlockRunAI/blockrun-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server