Developers

MCP tool catalog

Mofano exposes a Model Context Protocol (MCP) server so assistants like ChatGPT, Claude and Cursor can work with your Mofano account. Every tool below runs as the signed-in user, so results are scoped to your own brand kits, credits and creations.

Server endpoint

https://houmfjiaoxflwommhnhw.supabase.co/functions/v1/mcp

Authentication

OAuth 2.1 with dynamic client registration. You approve access on a consent screen.

Permissions

All tools are read-only today. Nothing is created, changed or deleted.

Available tools

4 tools. Text output is what the assistant reads; structured output is the machine-readable payload returned alongside it.

Who am I

whoami

Return the signed-in Mofano user's id and email.

Read-onlyIdempotentClosed world

Inputs

No inputs. Call this tool with an empty object.

Outputs

Text: Signed in as <email> (<userId>)

Field	Type	Required	Description
userId	string (uuid)	Yes	The authenticated user's Mofano id.
email	string \| null	No	Account email, when present on the token.

Get my credits

get_credits

Return the signed-in user's current Mofano credit balance and usage totals.

Read-onlyIdempotentClosed world

Inputs

No inputs. Call this tool with an empty object.

Outputs

Text: Balance: <n> credits (used <n>, purchased <n>).

Field	Type	Required	Description
balance	number	Yes	Credits currently available to spend.
total_purchased	number	Yes	Lifetime credits purchased.
total_used	number	Yes	Lifetime credits consumed by generations.
plan_credits	number	Yes	Credits granted by the active plan this cycle.
bonus_credits	number	Yes	Promotional or bonus credits.
cycle_resets_at	string (ISO date) \| null	No	When plan credits next reset.

List brand kits

list_brand_kits

List the signed-in user's brand kits (name, industry, tagline, colors). Returns up to 50, newest first.

Read-onlyIdempotentClosed world

Inputs

No inputs. Call this tool with an empty object.

Outputs

Text: Found <n> brand kit(s), followed by the JSON rows.

Field	Type	Required	Description
brand_kits[].id	string (uuid)	Yes	Brand kit identifier.
brand_kits[].name	string	Yes	Brand name.
brand_kits[].industry	string \| null	No	Industry the brand operates in.
brand_kits[].tagline	string \| null	No	Brand tagline or slogan.
brand_kits[].brand_colors	string[] \| null	No	Hex colors that make up the palette.
brand_kits[].default_cta	string \| null	No	Default call to action used in ads.
brand_kits[].is_active	boolean	Yes	Whether this is the currently selected kit.
brand_kits[].website_url	string \| null	No	Brand website, when provided.
brand_kits[].created_at	string (ISO date)	Yes	When the kit was created.

List recent studio assets

list_recent_assets

List the signed-in user's most recent generated studio assets (ads, logos, posters), newest first.

Read-onlyIdempotentClosed world

Inputs

Field	Type	Required	Description
limit	integer (1 to 50)	No	Max assets to return. Defaults to 10.
kind	string	No	Filter by asset kind, e.g. 'ad', 'logo', 'poster'.

Outputs

Text: Found <n> asset(s), followed by the JSON rows.

Field	Type	Required	Description
assets[].id	string (uuid)	Yes	Asset identifier.
assets[].kind	string	Yes	Asset kind, e.g. ad, logo, poster.
assets[].url	string	Yes	Public or signed URL to the rendered image.
assets[].label	string \| null	No	Human-readable label for the asset.
assets[].created_at	string (ISO date)	Yes	When the asset was generated.

Connecting a client

1. In your assistant's connector settings, add a custom MCP server using the endpoint above.
2. Sign in to Mofano when the browser opens, then approve the consent screen.
3. The tools appear in your assistant and run as you. Errors are returned as tool errors, including Not authenticated if the session expires.