Connect your MCP client to Syntasy

Use one server endpoint to generate media, check tasks, read history and access assets through your Syntasy account.

Server endpoint

JSON-RPC over HTTPS

/api/mcp

Generation

Images, video and audio tools call the same Syntasy generation pipeline.

Status

Poll tasks, fetch generation history and open authenticated media assets.

OAuth

Tokens are linked to a Syntasy user, so scopes, limits and billing are predictable.

Available tools

The MCP client will see these methods after tools/list.

  • syntasy_generate_image

    Creates or edits images from a prompt and references using the selected model and settings. Uses account credits.

  • syntasy_generate_video

    Starts video generation from a prompt and any image, video or audio inputs supported by the selected model. Uses account credits.

  • syntasy_generate_audio

    Starts audio generation with the selected model, mode and settings. Uses account credits.

  • syntasy_estimate_generation

    Validates the model, settings and input files and calculates the generation cost before it starts.

  • syntasy_analyze

    Analyzes up to 10 images or individual video frames according to your instructions and returns the result as JSON.

  • syntasy_embed

    Converts a batch of 1–100 texts into numerical vectors for semantic search and similarity comparison.

  • syntasy_chat

    Demo tool: returns sample text from a chat stream. It does not yet send the prompt to a language model.

  • syntasy_get_generation_status

    Checks a task by taskId to see whether generation is in progress, completed or failed.

  • syntasy_list_generations

    Returns your generation history with a type filter, search and pagination.

  • syntasy_get_generation

    Returns one of your generations by generationId, including its state and results.

  • syntasy_get_media_asset

    Returns a media asset URL by assetId: the original, thumbnail or video preview. Downloading a private file requires the same access token.

  • syntasy_list_models

    Lists available models and their parameters. Helps select a model by generation type, name and number of input files.

  • syntasy_help

    Searches Syntasy help for guidance on sections, workflow setup and where to find features.

  • syntasy_get_account

    Returns the current account’s credit balance, plan, role and registration date.

MCP integrations | Syntasy