---
title: "enrich_metadata tool call"
method: POST
path: "/api/tools/enrich_metadata"
tags: ["Tools"]
---

# enrich_metadata tool call

`POST /api/tools/enrich_metadata`

## Request

- Base URL: `https://studiomcphub.com`
- URL: `https://studiomcphub.com/api/tools/enrich_metadata`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Stripe-Payment-Intent`

Cost: 2 GCX ($0.20). Payment: GCX credits (Bearer token) or Stripe (X-Stripe-Payment-Intent header).

## Request body

- object
  - `artist_name` string: Artist/creator name (embedded in metadata)
  - `content_type` 'artwork' | 'photo': Content type hint: 'artwork' or 'photo' — affects analysis style
  - `context` string: Creator's brief — technical/artistic context for AI analysis (e.g. 'SD 3.5 Large, impressionist style')
  - `copyright_holder` string: Copyright owner name
  - `creation_year` string: 4-digit creation year
  - `image` string, required: Base64-encoded PNG/JPEG image
  - `soul_whisper` object: Optional personal message embedded in metadata — visible to anyone who reads the image's provenance (premium tier only)
    - `message` string: Personal message, dedication, or story behind the artwork (max 1000 chars)
    - `sender` string: Your name or pseudonym
  - `tier` 'standard' | 'premium': Metadata tier: 'standard' (1 GCX — SEO title/description/keywords/alt_text) or 'premium' (2 GCX — full Golden Codex 8-section analysis)
  - `title` string: Artwork title (leave blank for AI to suggest one)

## Response `200`

Tool result

## Other responses

- `402`: Payment required — returns GCX credit info and Stripe checkout link

---

[API](https://skmtc.dev/studiomcphub/apis/studiomcphub-api.md) · [All operations](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/studiomcphub/apis/studiomcphub-api/revisions/15995bc5ee2e?raw)