Generate images & videosin Claude Code with Auray

Connect Auray to Claude Code in under a minute

  1. 1

    Mint a key for the agent

    In the app, under Account → API Keys. The key you connect with is the key the agent spends, so give it the scopes it needs and a spending cap.

    Where keys are made
  2. 2

    Add the server

    One command. Nothing to install; the transport is plain HTTP.

    claude mcp add --transport http auray https://mcp.auray.ai/mcp \
      --header "Authorization: Bearer $AURAY_API_KEY"
  3. 3

    Ask for something

    Describe the image, clip, song or mesh you want. The agent finds a model, reads what it takes, runs it and hands you the file.

Things to ask for

Real requests, and what they made

The MCP guide
Matte black headphones on wet slate
PromptText to image

Matte black headphones on wet slate

“Commercial product packshot of matte black over-ear headphones resting on a slab of wet dark slate, fine water droplets beading on the slate and the headband, low-key studio lighting with a single large softbox from the upper left and a thin cool rim light tracing the ear cups, shallow depth of field, 100mm macro lens at f/4, deep charcoal background fading to black, subtle reflections in the wet stone, ultra-detailed textures, premium minimalist advertising photography, no logos, no text”

run_model · Krea 2 Turbo

A neon-lit alley at night in the rain
PromptText to image

A neon-lit alley at night in the rain

“A narrow Tokyo back alley at night in heavy rain, glowing neon signs in magenta, cyan and amber reflected in deep puddles on the wet asphalt, steam rising from a ramen stall vent, a lone figure with a clear umbrella walking away from camera in the mid-distance, cinematic 35mm lens at eye level, anamorphic lens flares, volumetric haze, moody blade-runner color grade, rich blacks, shallow depth of field, signs with abstract glowing shapes and no readable text”

run_model · Krea 2 Turbo

An editorial portrait in hard sunlight
PromptText to image

An editorial portrait in hard sunlight

“Editorial fashion portrait of a model in an oversized sculptural saffron-orange coat standing against a sun-bleached white stucco wall, hard midday sunlight casting crisp graphic shadows across the face and wall, confident gaze past the camera, 85mm lens at f/5.6, high contrast, saturated warm tones against a deep cobalt sky in the upper corner, magazine cover composition with generous negative space, film grain, no text, no logos”

run_model · Krea 2 Turbo

An astronaut, the visor reflecting a planet
PromptText to image

An astronaut, the visor reflecting a planet

“Close-up cinematic portrait of an astronaut in a plain, completely unmarked white spacesuit with no patches, no emblems and no flags anywhere on the fabric, the gold mirrored visor reflecting a vast alien desert landscape with twin setting suns and a ringed planet in the sky, fine scratches and dust on the visor, soft rim light on the helmet edges, deep space black background, 85mm lens, shallow depth of field, science-fiction film still, highly detailed suit fabric and hardware, no text, no flags, no insignia”

run_model · Krea 2 Turbo

Sail-Assisted Freighter Woodblock Feature
PromptText to image

Sail-Assisted Freighter Woodblock Feature

“Create a finished art-style restyle of a contemporary maritime documentary photograph for the opening spread of a serious sustainability magazine. The subject is Canopée, the sail-assisted cargo vessel used to transport Ariane 6 rocket…”

run_model · Nano Banana Pro

Subsea Cable Engineer Editorial Portrait
PromptText to image

Subsea Cable Engineer Editorial Portrait

“High-end documentary editorial photograph for a technology and infrastructure magazine, portraying a female subsea telecommunications cable engineer in her late 40s aboard a working cable-repair ship at night. She stands confidently…”

run_model · FLUX.1.1 [pro]

Wadden Sea Walking Campaign Hero
PromptText to image

Wadden Sea Walking Campaign Hero

“Create a premium landscape tourism campaign photograph promoting guided wadlopen, or mudflat hiking, in the Dutch Wadden Sea. At low tide, a small group of six adult travelers follows an experienced local guide across vast rippled tidal…”

run_model · GPT Image 2

Edwardian Station VFX Clean Plate
PromptText to image

Edwardian Station VFX Clean Plate

“Finished photorealistic VFX clean plate for an Edwardian period drama: the grand concourse of a British railway terminus circa 1908, completely empty after the digital removal of cast, crew, cameras, cables, markers, barriers, litter, and…”

run_model · Seedream 5.0 Pro

Subsea Cable Documentary Thumbnail
PromptText to image

Subsea Cable Documentary Thumbnail

“Polished editorial video thumbnail about subsea internet infrastructure, composed as a bold square graphic-design image. In the lower-right, show a photorealistic deep-sea remotely operated vehicle illuminating a thick fiber-optic cable on…”

run_model · Ideogram 2a

Rainwater Rebate Social Campaign Image
PromptText to image

Rainwater Rebate Social Campaign Image

“Premium documentary-style social campaign photograph for a city residential rainwater rebate program. In a contemporary brick courtyard during a warm summer cloudburst, a homeowner in a mustard-yellow rain jacket crouches beside a handsome…”

run_model · Kling IMAGE O3

Water Tower Listening Lounge
PromptText to image

Water Tower Listening Lounge

“High-end architectural interior photograph for a boutique hospitality listing: the circular listening lounge of a converted 1930s concrete water tower. The focal point is a sculptural walnut hi-fi console with a turntable and two large…”

run_model · Krea 2 Raw

The server

16 tools, one key

Each tool is one call to the API under the key you connected with. The ones that only read say so, and a refusal comes back as the tool’s answer — with the same error, the same advice and the same request id a curl would get.
  • search_models()

    Search models

    The catalogue, filtered by a word, a category, a status or a kind.

    search_modelsRead-only
  • get_model_schema()

    Model input schema

    What an address takes: its input schema, the scope a key needs, the hosts to call.

    get_model_schemaRead-only
  • get_pricing()

    Model price

    The price rule an address publishes, in credits — and whether a pass you hold covers it.

    get_pricingRead-only
  • search_docs()

    Search the documentation

    Titles, URLs and the matching passage from these docs.

    search_docsRead-only
  • run_model()

    Run a model and wait

    Run an address and wait for the answer, well inside an agent's own timeout; a job still running comes back as the job.

    run_modelSpends or changes
  • submit_job()

    Submit a job

    Submit without waiting; answers the request id and its three URLs.

    submit_jobSpends or changes
  • check_job()

    Job status

    Where a request is: IN_QUEUE, IN_PROGRESS or COMPLETED, with logs.

    check_jobRead-only
  • get_job_result()

    Job result

    What a completed request produced, and the signed download URLs.

    get_job_resultRead-only
  • cancel_job()

    Cancel a job

    Ask a request to stop; what wasn't made yet is refunded.

    cancel_jobSpends or changes
  • upload_file()

    Upload a file

    Put a file where a request can reach it and get the URL for the field that takes it.

    upload_fileSpends or changes
  • recommend_model()

    Recommend a model

    Rank addresses for a task in plain words, by what each makes and takes — arithmetic, not judgement.

    recommend_modelRead-only
  • chat()

    Ask a language model

    One turn with one of our chat models, optionally inside a thread; a long turn comes back as its thread.

    chatSpends or changes
  • read_chat()

    Read a chat thread

    One chat turn by its job id, or a whole thread in order — how a turn still being written is read back.

    read_chatRead-only
  • embed()

    Embed text

    Vectors for a string or a list of strings, charged by the token.

    embedSpends or changes
  • get_account()

    Account and credits

    The key's plan, balance, scopes, ceiling and passes — and where the credits went.

    get_accountRead-only
  • search_community()

    Search the Community

    What people published: works by words or a feed, and profiles — each with its page, model and files.

    search_communityRead-only

Every model

Every creative model, inside your agent

The agent reaches the whole catalogue with the key you give it — search it, read what a model takes, run it.

Still have questions?

Is there anything to install?

No. The server is an address — the transport is Streamable HTTP, one message per request, with no session to open — and your key goes in the Authorization header like every other call.

What can the agent spend?

Exactly what the key can. A tool has the key's scopes, its spending cap and its rate limits and no more, so mint a key for the agent with the scopes it needs and a cap you would accept losing.

Does it ask before it charges?

The read-only tools say so to the client, and the ones that spend, upload or cancel say they do not — so a client that runs read-only tools without asking still asks before one that charges.

What happens when a call is refused?

The refusal comes back as the tool's answer with the same error, docs link and request id a curl would get, plus whether retrying can help and what happened to the money — the agent reads it the way you would.

Does the old address still work?

Yes. The server moved to mcp.auray.ai on 28 September 2026, and api.auray.ai/v1/mcp still answers as the same server, so an agent configured with it keeps working.