Agent & Bot Guide

How to use StudioMCPHub to create, enhance, and protect images via the Golden Codex pipeline.

Quick Start (3 Steps)

Step 1: Register Your Wallet FREE

curl -X POST https://studiomcphub.com/api/wallet/register \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYOUR_WALLET_ADDRESS"}'

# Response: {"status": "created", "balance": 10, ...}
# You now have 10 GCX credits ($1.00 value)

Step 2: Choose Your Path

Step 3: Make Your First Call

# Include your wallet as Bearer token for GCX payment
curl -X POST https://studiomcphub.com/api/tools/upscale_image \
  -H "Authorization: Bearer 0xYOUR_WALLET" \
  -H "Content-Type: application/json" \
  -d '{"image": "BASE64_IMAGE_DATA", "scale": 4}'

Enhance Existing Images with Golden Codex

Already have images? Run them through the Golden Codex pipeline to add AI metadata, provenance, and professional-grade processing.

Step-by-Step: Enhance an Existing Image

# 1. Enrich — AI analyzes your image and generates Golden Codex metadata (2 GCX)
curl -X POST https://studiomcphub.com/api/tools/enrich_metadata \
  -H "Authorization: Bearer 0xYOUR_WALLET" \
  -H "Content-Type: application/json" \
  -d '{"image": "BASE64_IMAGE_DATA", "context": "Oil painting by a contemporary artist"}'

# Response includes full Golden Codex JSON: title, medium, palette,
# composition, symbolism, emotional resonance, provenance context

# 2. Infuse — Embed the metadata INTO the image file (1 GCX)
curl -X POST https://studiomcphub.com/api/tools/infuse_metadata \
  -H "Authorization: Bearer 0xYOUR_WALLET" \
  -H "Content-Type: application/json" \
  -d '{"image": "BASE64_IMAGE_DATA", "metadata": {...CODEX_JSON_FROM_STEP_1...}}'

# Response: image with XMP-gc, IPTC, and C2PA metadata embedded

# 3. Register Hash — Provenance protection, even if metadata is stripped (1 GCX)
curl -X POST https://studiomcphub.com/api/tools/register_hash \
  -H "Authorization: Bearer 0xYOUR_WALLET" \
  -H "Content-Type: application/json" \
  -d '{"image": "BASE64_INFUSED_IMAGE"}'

# Response: hash_id, perceptual hash registered in Aegis index
# Anyone can now verify your image with verify_provenance (FREE)

Save & Retrieve Assets

Store your generated images and pipeline outputs in your personal wallet storage. 100MB free per wallet.

# Save an image to your storage (1 GCX)
curl -X POST https://studiomcphub.com/api/tools/save_asset \
  -H "Authorization: Bearer 0xYOUR_WALLET" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "0xYOUR_WALLET",
    "key": "my-landscape-001",
    "data": "BASE64_IMAGE_DATA",
    "metadata": {"title": "Golden Hour Landscape", "pipeline": "full"}
  }'

# Retrieve it later (FREE)
curl -X POST https://studiomcphub.com/api/tools/get_asset \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYOUR_WALLET", "key": "my-landscape-001"}'

# List all your assets (FREE)
curl -X POST https://studiomcphub.com/api/tools/list_assets \
  -H "Content-Type: application/json" \
  -d '{"wallet": "0xYOUR_WALLET"}'

MCP Connection (Claude, Cursor, Cline)

For AI agents using the Model Context Protocol, connect to StudioMCPHub's Streamable HTTP transport:

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

Once connected, your AI agent can:

1. Call register_wallet to get 10 free GCX
2. Call search_tools to discover all available tools
3. Call upscale_image to enhance image resolution
4. Call enrich_metadata + infuse_metadata for provenance
5. Call save_asset to store results for later

Complete Tool Reference

Creative Tools

Dataset Tools (Alexandria Aeternum — 53K+ Museum Artworks)

Storage & Account Tools

Pricing Math

Payment Methods

• GCX Credits (recommended): Register wallet, get 10 free. Buy more with Stripe.
• Stripe: Card payment for credit purchases and per-call payments.

Every paid call earns 5% loyalty credits back. Volume discounts up to 30% off at $200+ monthly spend.