io.github.codex-curator/studiomcphub

Official27 tools

by codex-curator · Python

32 creative AI tools (18 free) for agents: generate, upscale, mockup, print, watermark.

Collection of 32 creative AI tools for generating, upscaling, and processing visual content.

Topics

artarweavecreative-aiesrgangolden-codeximage-generationmcpmcp-servernftprovenancestable-diffusionx402print-on-demand

Captured live from the server via tools/list.

upscale_image

Super-resolution using Real-ESRGAN on NVIDIA L4 GPU. 5 models for different content types. Default: 2x general upscale. ($0.20 / 2 GCX)

Parameters (3)

imagestringrequired
Base64-encoded PNG/JPEG image
modelstring
ESRGAN model to use. Options: 'realesrgan_x2plus' (2x, general — default), 'realesrgan_x4plus' (4x, general/photo), 'realesrgan_x4plus_anime' (4x, anime/illustrations), 'realesr_general_x4v3' (4x, fast general), 'realesr_animevideov3' (4x, anime video frames).
scaleinteger
Shorthand: 2 selects x2plus, 4 selects x4plus. Ignored if model is specified directly.

enrich_metadata

AI-powered artwork analysis. Two tiers: 'standard' (1 GCX) = SEO-optimized title, description, keywords, alt_text via Nova-Lite. 'premium' (2 GCX, default) = full 8-section Golden Codex museum-grade analysis via Nova/Gemini 2.5 Pro. Optionally customize metadata fields and add a Soul Whisper personal message. ($0.20 / 2 GCX)

Parameters (9)

imagestringrequired
Base64-encoded PNG/JPEG image
tierstring
Metadata tier: 'standard' (1 GCX — SEO title/description/keywords/alt_text) or 'premium' (2 GCX — full Golden Codex 8-section analysis)
content_typestring
Content type hint: 'artwork' or 'photo' — affects analysis style
contextstring
Creator's brief — technical/artistic context for AI analysis (e.g. 'SD 3.5 Large, impressionist style')
artist_namestring
Artist/creator name (embedded in metadata)
titlestring
Artwork title (leave blank for AI to suggest one)
copyright_holderstring
Copyright owner name
creation_yearstring
4-digit creation year
soul_whisperobject
Optional personal message embedded in metadata — visible to anyone who reads the image's provenance (premium tier only)

infuse_metadata

Embed metadata into image via ExifTool. Two modes: 'standard' (XMP/IPTC only — title, description, keywords, copyright) or 'full_gcx' (default — full Golden Codex XMP-gc namespace + IPTC + C2PA + soulmark + hash registration). ($0.10 / 1 GCX)

Parameters (3)

imagestringrequired
Base64-encoded PNG/JPEG image
metadataobjectrequired
Metadata JSON to embed. For standard: {title, description, keywords, alt_text, copyright_holder}. For full_gcx: Golden Codex JSON from enrich_metadata.
metadata_modestring
Infusion mode: 'standard' (XMP/IPTC fields only) or 'full_gcx' (full Golden Codex + soulmark + hash registration)

register_hash

Parameters (1)

imagestringrequired
Base64-encoded PNG/JPEG image

verify_provenance

Strip-proof provenance verification via Aegis hash index. FREE - no payment required. (FREE)

Parameters (1)

imagestringrequired
Base64-encoded PNG/JPEG image

search_artworks

Search 53K+ museum artworks from Alexandria Aeternum (MET, Chicago, NGA, Rijksmuseum, Smithsonian, Cleveland, Paris). FREE. (FREE)

Parameters (3)

querystringrequired
Search query (e.g. 'impressionist landscape', 'Monet', 'Dutch Golden Age')
museumstring
Filter by museum (met, chicago, nga, rijks, smithsonian, cleveland, paris)
limitinteger
Max results (1-100)

get_artwork

Get Human_Standard metadata (500-1200 tokens) + signed image URL for a museum artwork. ($0.10 / 1 GCX)

Parameters (1)

artifact_idstringrequired
Artifact ID from search results (e.g. 'met_437419')

get_artwork_oracle

Get Hybrid_Premium 111-field NEST analysis (2K-6K tokens) + image. Deep AI visual analysis with color palette, composition, symbolism, emotional mapping. ($0.20 / 2 GCX)

Parameters (1)

artifact_idstringrequired
Artifact ID from search results (e.g. 'met_437419')

batch_download

Bulk download metadata + images from Alexandria Aeternum (min 100 artworks). ($5.00 / 50 GCX)

Parameters (3)

dataset_idstring
Dataset ID
quantityinteger
Number of artworks (min 100)
offsetinteger
Start offset for pagination

compliance_manifest

Get AB 2013 (California) + EU AI Act Article 53 compliance manifests for dataset usage. FREE. (FREE)

Parameters (2)

dataset_idstring
Dataset ID
regulationstring
Filter: ab2013, eu_ai_act, or all

resize_image

Resize an image to target dimensions. Supports fit modes: 'cover' (crop to fill), 'contain' (fit within, letterbox), 'stretch' (exact size). Useful for preparing images for specific platforms, thumbnails, or social media. FREE. (FREE)

Parameters (6)

imagestringrequired
Base64-encoded PNG/JPEG image
widthintegerrequired
Target width in pixels (1-8192)
heightintegerrequired
Target height in pixels (1-8192)
modestring
Resize mode: 'contain' (fit within bounds, preserve aspect ratio), 'cover' (crop to fill), 'stretch' (exact size, may distort)
formatstring
Output format
qualityinteger
JPEG/WebP quality (1-100)

extract_palette

Extract dominant color palette from an image. Returns hex/RGB/HSL colors with percentages, CSS names, and complementary colors. Great for design systems, mood boards, and color matching. FREE. (FREE)

Parameters (3)

imagestringrequired
Base64-encoded PNG/JPEG image
num_colorsinteger
Number of colors to extract (3-12)
formatstring
Color format in output

remove_background

Remove image background using AI (U2-Net). Returns RGBA PNG/WebP with transparent background. Perfect for product photos, portraits, and design assets. FREE. (FREE)

Parameters (2)

imagestringrequired
Base64-encoded PNG/JPEG image
output_formatstring
Output format

mockup_image

Place your design onto product mockups (t-shirt, poster, canvas, phone case, mug, tote bag). Instant product visualization for e-commerce and print-on-demand. FREE. ($0.10 / 1 GCX)

Parameters (3)

imagestringrequired
Base64-encoded design image
productstring
Product type
background_colorstring
Background hex color

convert_color_profile

Convert between sRGB and CMYK color profiles. Essential for print production. CMYK output as TIFF with embedded DPI. FREE. (FREE)

Parameters (3)

imagestringrequired
Base64-encoded PNG/JPEG image
target_profilestring
Target color profile
dpiinteger
Output DPI (72-1200)

print_ready

Prepare images for professional printing with DPI, bleed margins, crop marks. Supports A4, A3, Letter, poster (24x36), custom sizes. Output as TIFF or PDF. FREE. (FREE)

Parameters (8)

imagestringrequired
Base64-encoded PNG/JPEG image
dpiinteger
Output DPI
bleed_mmnumber
Bleed margin in mm (0-10)
crop_marksboolean
Draw crop marks in bleed area
output_formatstring
Output format
product_sizestring
Standard paper size
custom_width_mmnumber
Custom width in mm (required if product_size=custom)
custom_height_mmnumber
Custom height in mm (required if product_size=custom)

vectorize_image

Convert raster images to SVG vector format. Supports color and binary modes with precision controls. Returns raw SVG XML string. FREE. (FREE)

Parameters (4)

imagestringrequired
Base64-encoded PNG/JPEG image
color_precisioninteger
Color clustering precision (1-10, higher = more colors)
filter_speckleinteger
Speckle filter (0-100, higher = fewer small artifacts)
modestring
Vectorization mode

watermark_embed

Embed invisible DCT-domain watermark into an image. Encodes a text payload into luminance channel frequency coefficients. Survives light compression. FREE. (FREE)

Parameters (3)

imagestringrequired
Base64-encoded PNG/JPEG image
payloadstringrequired
Text payload to embed (max 256 chars)
strengthnumber
Embedding strength (0.1-1.0, higher = more robust but more visible)

watermark_detect

Detect and extract invisible DCT watermark from an image. Returns the embedded text payload if found. FREE. (FREE)

Parameters (1)

imagestringrequired
Base64-encoded PNG/JPEG image

save_asset

Save an image or data to your personal wallet storage. 100MB free per wallet, 500 assets max. ($0.10 / 1 GCX)

Parameters (5)

walletstringrequired
Your EVM wallet address (0x...)
keystringrequired
Unique name for this asset (e.g., 'my-landscape', 'pipeline-001')
datastringrequired
Base64-encoded data (image, JSON, etc.) — max 10MB
content_typestring
MIME type
metadataobject
Optional metadata JSON to store alongside

get_asset

Retrieve a stored asset from your wallet storage by key. FREE. (FREE)

Parameters (2)

walletstringrequired
Your EVM wallet address (0x...)
keystringrequired
Asset key to retrieve

list_assets

List all assets in your wallet storage with sizes and metadata. FREE. (FREE)

Parameters (1)

walletstringrequired
Your EVM wallet address (0x...)

delete_asset

Delete an asset from your wallet storage. FREE. (FREE)

Parameters (2)

walletstringrequired
Your EVM wallet address (0x...)
keystringrequired
Asset key to delete

register_wallet

Register your wallet to get 10 FREE GCX credits ($1 value). New wallets only — enough to try upscale + enrich. Purchase more via GCX packs. FREE. (FREE)

Parameters (1)

walletstringrequired
Your EVM wallet address (0x...)

check_balance

Check your GCX credit balance, loyalty rewards, and volume tier. FREE. (FREE)

Parameters (1)

walletstringrequired
Your EVM wallet address (0x...)

search_tools

Discover available tools by category or price without loading all schemas. Start here to save tokens. (FREE)

Parameters (3)

querystring
Search query to filter tools by name or description
categorystring
Filter by category
max_price_usdnumber
Max price per call in USD (0 = free only)

get_tool_schema

Get the full JSON Schema and usage examples for a specific tool. Use after search_tools to load only what you need. (FREE)

Parameters (1)

tool_namestringrequired
Tool name from search_tools results (e.g. 'generate_image')

README.md5 KBView on GitHub

StudioMCPHub

Creative AI tools and art datasets for autonomous agents.

StudioMCPHub is a production MCP server offering 32 tools (18 free): image generation, upscaling, background removal, product mockups, CMYK conversion, print-ready PDF, SVG vectorization, invisible watermarking, AI metadata enrichment, provenance registration, permanent Arweave storage, NFT minting, and access to 53,000+ museum artworks from Alexandria Aeternum. Agents pay per call with x402 USDC on Base L2 — no API keys, no accounts, no sign-up.

Quick Start

One-click install for Cursor:

Install in Cursor

Or add to any MCP client config:

json

{
  "mcpServers": {
    "studiomcphub": {
      "url": "https://studiomcphub.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Then call search_tools to discover available tools without loading all 32 schemas:

code

search_tools({ "category": "all" })

Tools

Discovery (FREE)

Tool	Description
`search_tools`	Discover tools by category, price, or keyword (~98% token savings)
`get_tool_schema`	Get full JSON Schema + examples for a specific tool

Creative Pipeline

Tool	Price	Description
`generate_image`	$0.20	SD 3.5 Large text-to-image on NVIDIA L4 GPU
`upscale_image`	$0.20	Real-ESRGAN 4x super-resolution
`enrich_metadata`	$0.20	Gemini-powered 111-field Golden Codex analysis
`infuse_metadata`	$0.10	ExifTool XMP/IPTC/C2PA metadata embedding
`register_hash`	$0.10	256-bit perceptual hash with LSH band indexing
`store_permanent`	$1.50	Arweave L1 permanent immutable storage
`mint_nft`	$1.00	Polygon NFT with on-chain provenance link
`verify_provenance`	FREE	Perceptual hash lookup against Aegis index
`full_pipeline`	$0.50	All stages in one call

Alexandria Aeternum Dataset

53,000+ public domain artworks from 7 world-class institutions.

Tool	Price	Description
`search_artworks`	FREE	Search by keyword, artist, period, or style
`get_artwork`	$0.10	Human-sourced metadata + signed image URL
`get_artwork_oracle`	$0.20	111-field NEST deep visual analysis
`batch_download`	$5.00	Bulk metadata + images (min 100)
`compliance_manifest`	FREE	AB 2013 + EU AI Act compliance docs

Payment

x402 (recommended for agents): Pay per call with USDC on Base L2. Server returns HTTP 402 with payment instructions. No account needed.

Stripe: Traditional card payment per call with API key.

GCX Credits: Pre-purchase tokens at volume discounts — $5 (50 GCX), $50 (600 GCX, 17% off), $100 (1600 GCX, 38% off).

Volume Discounts

Automatic per-wallet discounts based on 30-day rolling spend:

Tier	Spend	Discount
Standard	$0–49	0%
Active	$50–99	10%
Pro	$100–199	20%
Studio	$200+	30%

Check your tier: GET https://studiomcphub.com/api/agent/tier/{wallet_address}

Loyalty

Every paid call earns 5% credit-back as loyalty GCX. No sign-up, no expiration.

Discovery Endpoints

Endpoint	Description
`https://studiomcphub.com/mcp`	MCP Streamable HTTP endpoint
`https://studiomcphub.com/.well-known/mcp.json`	MCP server discovery
`https://studiomcphub.com/.well-known/agent.json`	A2A Agent Card
`https://studiomcphub.com/llms.txt`	LLM-readable documentation
`https://studiomcphub.com/pricing`	Pricing page

Self-Hosting

bash

git clone https://github.com/codex-curator/studiomcphub.git
cd studiomcphub
pip install -r requirements.txt
# Set required environment variables (see .env.example)
gunicorn --bind 0.0.0.0:8080 --workers 2 --threads 4 src.mcp_server.server:app

Or with Docker:

bash

docker build -t studiomcphub .
docker run -p 8080:8080 studiomcphub

Research

Alexandria Aeternum metadata density improves VLM visual perception by +25.5% and semantic coverage by +160.3%. See The Density Imperative.

License

MIT — Metavolve Labs, Inc.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "studiomcphub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://studiomcphub.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

upscale_image

enrich_metadata

infuse_metadata

register_hash

verify_provenance

search_artworks

get_artwork

get_artwork_oracle

batch_download

compliance_manifest

resize_image

extract_palette

remove_background

mockup_image

convert_color_profile

print_ready

vectorize_image

watermark_embed

watermark_detect

save_asset

get_asset

list_assets

delete_asset

register_wallet

check_balance

search_tools

get_tool_schema

StudioMCPHub

Quick Start

Tools

Discovery (FREE)

Creative Pipeline

Alexandria Aeternum Dataset

Payment

Volume Discounts

Loyalty

Discovery Endpoints

Self-Hosting

Research

Links

License

Install