RYLA

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Generate AI influencer photos, face swaps, and character sheets with a consistent face.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "RYLA": {
      "url": "https://mcp.ryla.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• ryla_generate_base_image

  Generate base character images from a niche/vibe/prompt. Returns a jobId; poll with ryla_generation_status.

  Parameters:

  • vibe — string — Overall vibe/style descriptor
  • niche — string — Content niche, e.g. "fitness"
  • nsfwEnabled — boolean — Enable unrestricted fan content generation
  • promptInput — string — Free-form prompt text

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_face_swap

  Swap a character face onto a reference base image. Returns the generation result.

  Parameters:

  • baseImageUrl (required) — string — Reference/base image URL to swap the face from
  • prompt (required) — string — Prompt for the target image
  • nsfw — boolean — Enable unrestricted fan content generation
  • seed — integer — Random seed for reproducibility
  • characterId — string — Character UUID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_character_sheet

  Build the 18-shot identity reference sheet for an existing character (the live replacement of the retired character sheet; flat, no extra credits). Use ryla_list_characters to find a characterId. Returns a sheetJobId; poll with ryla_generation_status.

  Parameters:

  • characterId (required) — string — Character UUID
  • nsfw — boolean — Character unrestricted intent (the sheet itself stays SFW)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generation_status

  Check the status of a generation job by its jobId.

  Parameters:

  • jobId (required) — string — The jobId returned by a ryla_generate_* tool call
  • detail — string — slim (default): status, output URLs and the inputs you set. full: the raw job row incl. internal dispatch fields (large; for debugging).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_account_credits_balance

  Check the authenticated user's current RYLA credit balance.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_account_gallery_list

  List the authenticated user's most recent generated images/jobs.

  Parameters:

  • limit — integer — Max number of items to return (default 20, max 50)
  • detail — string — slim (default): status, output URLs and the inputs you set. full: raw job rows incl. internal dispatch fields (very large).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_list_characters

  List the authenticated user's existing characters (AI influencers) so you can pick a characterId for the other generation tools. `loraReady` tells you whether `useLora: true` has a trained LoRA to use. There is no tool to CREATE a character -- that happens in the RYLA app at app.ryla.ai.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_image

  Generate Studio-quality images for an existing character with full creative control (scene, outfit, pose, lighting, expression, style). This is the primary, full-featured image tool -- prefer it over ryla_generate_base_image. Character must already exist; use ryla_list_characters to find a characterId. Returns a jobId; poll with ryla_generation_status.

  Parameters:

  • characterId (required) — string — Character UUID to generate images for
  • nsfw — boolean — Enable unrestricted fan content generation
  • seed — integer — Base seed; each image increments it
  • count — integer — Number of images to generate
  • scene — string — Scene preset or description. Required unless templateId is given.
  • loraId — string — LoRA id to use, if not the default for this character
  • outfit — string — Outfit description
  • poseId — string — Pose preset id, e.g. "standing-casual"
  • quality — string — Quality tier: "standard" or "2k" (HD, default), "ultra" or "4k" (4K, costs more credits)
  • useLora — boolean — Use the character LoRA for face consistency, if trained
  • lighting — string — Lighting preset, e.g. "natural.goldenHour"
  • shotType — string — Camera framing, e.g. "close-up-portrait", "full-body"
  • requestId — string — Optional UUID for this generation intent. Omit it and one is created for you (returned in the result). Pass the SAME id when retrying after an error or a lost response, so the retry is not charged twice.
  • expression — string — Facial expression preset, e.g. "positive.smile"
  • templateId — string — Template id from ryla_list_templates. Fills scene, outfit, pose, style, lighting and aspect ratio from the template; anything you set yourself wins.
  • aspectRatio — string — Image aspect ratio. Required unless templateId is given (then the template ratio is used).
  • environment — string — Environment preset or description
  • stylePreset — string — Visual style preset (default ultraRealistic)
  • loraStrength — number — LoRA strength, 0.1-2.0
  • realismStyle — boolean — Apply realism post-processing style
  • templateMode — string — With templateId: "exact" (default) keeps the template pose, outfit and background; "inspired" makes a similar but different image.
  • promptEnhance — boolean — Enable AI prompt enhancement (default true)
  • enableFaceSwap — boolean — Route through face-swap for the reference image
  • referenceMethod — string — Reference image method (default instantid)
  • antiDetectPreset — string — Anti-detection intensity (default moderate); advanced/maximum require Pro
  • socialMediaReady — boolean — Apply anti-AI-detection post-processing
  • referenceImageUrl — string — Reference image URL for face consistency (InstantID/PuLID), as an alternative to LoRA
  • referenceStrength — number — Reference image strength, 0.1-1.0

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_upscale_image

  Upscale one of your own generated images (2x or 4x, faithful, no new content). Costs credits. imageId comes from ryla_generation_status (output.imageIds) or ryla_account_gallery_list. Returns a job; poll with ryla_generation_status.

  Parameters:

  • imageId (required) — string — Image id (output.imageIds of a finished job)
  • scale — number — Upscale factor, 2 or 4 (default chosen by the server)
  • requestId — string — Optional UUID; pass the same one when retrying so you are not charged twice

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_character_reference_images

  Get fresh URLs of a character's reference material: its base image and the 16-shot reference sheet. Pass any of these as referenceImageUrl to ryla_generate_image to keep the face consistent. URLs expire after about an hour. Read only: never regenerates anything.

  Parameters:

  • characterId (required) — string — Character UUID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_video

  Generate a video from an existing character image (image-to-video, Wan 3.0). Character must already exist; use ryla_list_characters to find a characterId. By default the newest completed image of the character is animated; pass sourceImageId (imageIds from ryla_account_gallery_list) to pick one. Priced per second and resolution (720p = 240 credits/s, 480p 120, 1080p 470; unrestricted x2). Returns a jobId; poll with ryla_generation_status.

  Parameters:

  • characterId (required) — string — Character UUID to generate video for
  • nsfw — boolean — Enable unrestricted fan content generation
  • prompt — string — Optional prompt/description for the motion
  • duration — integer — Video duration in whole seconds, 2 to 30
  • requestId — string — Idempotency key: the same id returns the same job and never charges twice. Generated when omitted.
  • wantAudio — boolean — Generate sound with the video
  • resolution — string — Output resolution (drives the price)
  • aspectRatio — string — Video aspect ratio
  • sourceImageId — string — Image UUID to animate (default: newest completed image)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_voice

  Generate speech audio (TTS) in an existing character's voice. Character must already exist; use ryla_list_characters to find a characterId.

  Parameters:

  • characterId (required) — string — Character UUID
  • text (required) — string — Text to convert to speech (max 1000 chars)
  • speed — number — Speech speed multiplier, 0.5-2.0
  • gender — string — Character gender, to pick a default voice when voiceIdentityId is absent
  • emotion — string — Emotion style for the voice
  • voiceIdentityId — string — Specific voice identity id, if known (otherwise the character default is used)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_avatar_video

  Generate a talking avatar video from a character face + an audio track (kie.ai InfiniTalk). Pro plan required. Character must already exist; use ryla_list_characters to find a characterId. Returns a jobId; poll with ryla_generation_status.

  Parameters:

  • characterId (required) — string — Character UUID to use as the avatar face
  • prompt — string — Optional prompt/description for the avatar video
  • audioUrl — string — URL of the audio file (MP3/WAV/M4A, max 5MB, 2-60s). Required unless voiceNoteId is set.
  • duration — number — Video duration in seconds
  • modelTier — string — Model quality tier (default pro)
  • aspectRatio — string — Video aspect ratio (default 16:9)
  • voiceNoteId — string — UUID of a saved voice note to use as the audio track instead of audioUrl
  • sourceImageId — string — UUID of a specific image to use as the face source. If omitted, the character base image is used.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_video_swap

  Swap a character face into an existing video (face swap onto uploaded footage). Pro plan required. videoUrl must be a video you already uploaded to your RYLA account. Character must already exist; use ryla_list_characters to find a characterId. Returns a jobId; poll with ryla_generation_status.

  Parameters:

  • characterId (required) — string — Character UUID whose face is swapped into the video
  • videoUrl (required) — string — URL of the source video to swap (must be a RYLA-hosted storage URL you own)
  • sourceType — string — Source type (default upload)
  • outfitPrompt — string — Outfit description, used only when outfitEnabled is true
  • outfitEnabled — boolean — Enable an outfit-change prompt
  • backgroundPrompt — string — Background description, used only when backgroundEnabled is true
  • backgroundEnabled — boolean — Enable a background-change prompt

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_generate_lip_sync

  Generate a talking video by lip-syncing a portrait image to an audio track (kie.ai InfiniTalk). Both portraitImageUrl and audioUrl must be RYLA-hosted URLs you own. Pro plan required. This capability may not be available on your account yet (internal rollout, pricing not finalized) -- an unavailable-feature error means it is not yet live for you.

  Parameters:

  • portraitImageUrl (required) — string — Portrait/face image URL (RYLA-hosted storage URL you own)
  • audioUrl (required) — string — Audio track URL (RYLA-hosted storage URL you own)
  • prompt (required) — string — Prompt describing the desired output (required)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_list_templates

  Find RYLA templates (ready-made looks: scene, outfit, pose) by name or tag. Returns template ids. Pass an id as `templateId` to ryla_generate_image to generate your character in that template. Unrestricted (NSFW) templates are only listed when `unrestricted` is true.

  Parameters:

  • page — integer — Page, starting at 1
  • limit — integer — Number of templates to return (default 10, max 30)
  • search — string — Search text, e.g. "cafe", "boots", "selfie bed"
  • unrestricted — boolean — Include unrestricted fan content templates

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ryla_server_info

  Get RYLA external MCP server configuration and connection info

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.