Artiofy Artiofy
Start

Model Context Protocol

Artiofy MCP

Connect the Artiofy generation engine to Claude, Cursor, and any MCP-capable client. You connect with your own account and spend your own credits — the same engine that runs the site.

Get started Explore the 25 tools
Compatible: Claude Cursor Any MCP client

Connection URL

Add this address to your client as an MCP connector. One URL, no API key to paste — authentication happens through OAuth in your browser.

https://artiofy.com/mcp-connect

Set up in three steps

01

Open your client

In Claude Desktop, Cursor, or any MCP-capable client, open the connector settings.

02

Add the connector

Paste the connection URL above as a new MCP connector. A single URL is all it takes.

03

Sign in & authorize

Sign in with Artiofy via OAuth and grant access. From then on your client acts on your own account.

25 tools, 5 families

Each tool maps to the same engine the website uses. Your client composes them into multi-step workflows.

Generation

7
  • list_models

    Active image / video / text models + parameter schema

  • models_search

    Describe a task → up to 5 matching models with usage hints

  • generate_image

    Start an image generation → generationId

  • generate_video

    Start a video generation (t2v / i2v) → generationId

  • get_job

    Generation status + media URLs (poll until done)

  • estimate_cost

    Exact USD cost before you generate (no charge)

  • list_generations

    Past generations (feed into next steps)

Character

7
  • create_upload_ticket

    Get a short-lived URL to upload a local image via curl — no base64, no context bloat

  • upload_reference_image

    Base64 fallback upload when your client has no shell → mediaId

  • create_character

    Create a character from reference images

  • add_character_reference

    Add another reference to a character

  • generate_character_view

    Generate a consistent new character view

  • list_characters

    List your characters + their reference media ids

  • get_character

    One character in detail: its views + reference media

Organization

7
  • list_folders

    Browse your folders (media + child counts, no extra calls)

  • get_folder

    Open a folder: its subfolders + the media inside (paginated)

  • list_media

    List/filter your media by folder, format or source — unfiled included

  • search_media

    Search your media by filename or generation prompt

  • create_folder

    Create a folder (nest it, color it)

  • update_folder

    Rename, recolor, favorite or re-parent a folder

  • move_media

    File media into a folder in bulk — also files new generations

Agent

2
  • list_text_models

    Text models available for agents

  • create_chat_agent

    Create a system-prompted chat agent (TextApp)

Account

2
  • get_balance

    Your current credit balance

  • profile_get

    Name, email, role, status + balance ("who am I")

How it flows

One request from your client becomes a chain of tool calls. The client decides each step from the previous result — no clicking through the UI.

models_search

Find the right model

generate_image

Generate

get_job

Read the result

move_media

File it into a folder

Why MCP?

MCP doesn't make a single generation faster — the real value is autonomous multi-step orchestration. Your client picks a model, builds a character, generates image and video, reads the result, and feeds it into the next step — without you clicking through each one.

Everything runs on your own account and your own credits. It is the same engine that powers the site, driven straight from inside your client.