Ganai MCP server

Connect Ganai to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Ganai MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list avatars tool in Ganai
  • Use the create avatar tool in Ganai
  • Use the get photo avatar inferences tool in Ganai
  • Use the create personalized videos tool in Ganai
  • Use the delete lip sync videos tool in Ganai
  • Use the create lip sync video tool in Ganai

Supported Tools

list_avatars

List Avatars

List AI avatars with optional filters for title, status, and date range. Also supports fetching detailed information for a specific avatar by ID, including processing and consent verification results. Supports pagination.

create_avatar

Create Avatar

Create a new AI avatar from a video recording. The video must be a publicly accessible MP4 file (max 300 MB) with at least 30 seconds of clear footage showing a single face. After creation, consent verification is required before the avatar can be used to generate videos. An optional webhook URL can be provided to receive status updates during processing.

get_photo_avatar_inferences

Get Photo Avatar Inferences

Retrieve photo avatar video inference details. Can fetch a specific inference by ID or list inferences with optional filters for photo avatar ID, title, status, and date range. Use this to check on the progress of photo avatar video generation.

create_personalized_videos

Create Personalized Videos

Generate personalized videos in bulk for a project (Studio API). Each video is customized with per-recipient variable values (e.g., names, custom text). The variable keys depend on how the project was configured. Video generation is asynchronous -- use the returned inference IDs to check status or set up a webhook for notifications. Use **List Projects** to see available project tags/variables.

delete_lipsyncs

Delete Lip-Sync Videos

Bulk delete lip-sync video inferences by their inference IDs.

create_lipsync

Create Lip-Sync Video

Create a lip-synchronized video by combining a source video with an audio file. The video must contain a visible face and the audio must contain speech. Alternatively, use the audio from the source video itself. Video generation is asynchronous -- use the inference ID to check status. An optional webhook URL can receive completion notifications.

get_sfx_history

Get Sound Effects History

Retrieve the history of previously generated sound effects, or fetch audio for a specific sound effect by inference ID. History entries include prompt, generation parameters, and timestamps. Use the inference ID to retrieve a downloadable WAV file and the audio data.

generate_speech

Generate Speech

Convert text into natural-sounding speech using a specified voice. Provides a downloadable WAV file and base64-encoded WAV audio data. Supports 22+ Indic languages and English, including code-mixed text. Use the **List Voices** tool first to find available voice IDs.

list_projects

List Projects

List all video projects within a workspace (Studio API). Returns project details including project type, status, available credits, tags, and video URLs. The project ID is required for creating personalized videos and managing webhooks.

create_photo_avatar

Create Photo Avatar

Create an AI avatar from a still photo image. The image must be a publicly accessible URL containing a clear face. Once published, the photo avatar can be used to generate videos with lip-synced speech. An optional webhook URL can receive status updates.

generate_avatar_video

Generate Avatar Video

Generate an HD video from a published AI avatar. Provide a text script (up to 2,000 characters) or an audio URL for the avatar to speak. If both are provided, the audio URL takes priority. The avatar must be in "published" status. Video generation is asynchronous -- use the inference ID to check status later.

generate_photo_avatar_video

Generate Photo Avatar Video

Generate a video from a published photo avatar. Provide either an audio URL alone, or both a text script and voice sample URL together. The photo avatar will be animated to speak the provided audio or text. Video generation is asynchronous.

generate_sound_effect

Generate Sound Effect

Generate audio sound effects from a text description. Configure duration, number of variations, and a creativity slider. Provides a downloadable WAV file and base64-encoded WAV audio for each variation. Examples: "thunderstorm rumbling", "birdsong at dawn", "keyboard typing".

get_tts_history

Get TTS History

Retrieve the history of previously generated text-to-speech audio. Returns inference IDs, input text, voice names, timestamps, and audio file URLs. Supports pagination.

list_lipsyncs

List Lip-Sync Videos

List lip-sync video inferences with optional filters, or get details for a specific lip-sync inference by ID. Supports filtering by title, status, and date range with pagination.

list_photo_avatars

List Photo Avatars

List photo avatars with optional filters, or get details for a specific photo avatar by ID. Supports filtering by title, status, and date range with pagination.

list_workspaces

List Workspaces

Retrieve all workspaces the authenticated user belongs to (Studio API). Returns workspace IDs, titles, and the user's role in each workspace. The workspace ID is required for project and video operations.

list_voices

List Voices

Retrieve all available voices for text-to-speech and avatar video generation. Returns voice IDs, names, descriptions, and sample audio URLs. Use a voice ID from this list when generating speech or creating avatar videos.

get_avatar_inferences

Get Avatar Inferences

Retrieve avatar video inference details. Can fetch a specific inference by ID or list all inferences with optional filters for avatar ID, title, status, and date range. Use this to check on the progress of avatar video generation jobs.

get_video_status

Get Video Status

Check the generation status of a personalized video (Studio API). Returns the current status, video URL (when complete), permalink, and any error details. Use inference IDs returned from **Create Personalized Videos**.

delete_avatars

Delete Avatars

Bulk delete avatars and/or avatar video inferences. Deleting an avatar also deletes all associated video inferences. Provide avatar IDs, inference IDs, or both to delete.

Connect Ganai to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Ganai in Metorial. In your Metorial portal, enable the Ganai MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Ganai tools.

Run Ganai through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Ganai and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Ganai tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Ganai

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Technical notes for Ganai

Generate personalized videos, text-to-speech audio, AI avatars, lip-synced videos, and sound effects. Create AI avatars from video or photo, then produce HD videos with synthesized speech from text scripts. Convert text to natural-sounding speech in 70+ languages including 22+ Indic languages. Generate lip-synchronized videos by combining audio with source video. Create audio sound effects from text descriptions. Run personalized video campaigns at scale by specifying per-recipient variables for bulk video generation with unique landing pages. Manage voices, avatars, projects, and workspaces.

Frequently asked questions

Common questions about connecting Ganai to AI agents with Metorial.

  1. How many tools does the Ganai MCP server have?
    The Ganai MCP server exposes 22 tools, including List Avatars, Create Avatar, Get Photo Avatar Inferences. Each one is governed and traced through Metorial.
  2. Ganai exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ganai MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Ganai and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Ganai MCP server yourself or use the hosted gateway.

Connect Ganai to production AI agents

See how Metorial gives your team governed access to Ganai, with tracing and security controls built in.