# AKOOL MCP

> Hosted MCP for AKOOL face swap, character swap, image-to-video, TTS and avatar lookup.

- **Category:** Avatars & Performance
- **Vendor:** AKOOL (official)
- **Pricing:** credits
- **Verified:** 2026-10-04

## What it does

AKOOL's official remote MCP puts its Open API behind one streamable-HTTP endpoint: image generation and upscaling, image-to-video with effects and audio replacement, image and video face swap, character swap, avatar discovery, TTS with a voice list, and face detection. Most jobs are async, so the agent pairs each create call with a *_result poll. For a filmmaker-agent it is a performance-replacement and identity-swap kit — stand-in to principal swaps, pickup fixes, animatics from stills — rather than a general video-model shelf.

## Connect

- Remote endpoint: `https://openapi.akool.com/mcp/v1`
- Remote headers required: `x-client-id`, `x-client-secret`
- Claude Code: `claude mcp add --transport http akool-mcp https://openapi.akool.com/mcp/v1 --header "x-client-id: YOUR_CLIENT_ID" --header "x-client-secret: YOUR_CLIENT_SECRET"`

**Auth:** api_key — <https://akool.com/workspace/current/api/credentials> (Client ID + Client Secret, sent as headers)

## Capabilities

`face-swap` · `character-swap` · [image-to-video](https://mcp.film/capabilities/image-to-video.md) · [text-to-image](https://mcp.film/capabilities/text-to-image.md) · [upscaling](https://mcp.film/capabilities/upscaling.md) · [tts](https://mcp.film/capabilities/tts.md) · `avatar-library` · `face-detection` · [async-jobs](https://mcp.film/capabilities/async-jobs.md)

## Sample tools

`faceswap_video` · `faceswap_result` · `character_swap_create` · `video_image2video_create` · `video_image2video_results` · `image_create` · `image_upscale` · `audio_tts` · `avatar_list` · `facedetect_detect` · `account_credit` · `account_models`

## Field notes

Checked against AKOOL's own MCP docs on 4 Oct 2026. The endpoint answers a plain GET with 405, which is what a POST-only streamable-HTTP server should do, but no tools were run because there is no anonymous path. Copy the command above rather than the docs' quick-add line: AKOOL's version omits `--transport http`, and without it Claude Code treats the URL as a stdio command. Auth is a Client ID and Client Secret pair sent as x-client-id / x-client-secret headers — no OAuth, so both secrets sit in your client config; the docs say to use env substitution and never commit them. There is no public repo and no local package; the AKOOL-Official GitHub org holds only API demos. Scope is narrower than the AKOOL web app: the only generative-video tool is image-to-video, and video translation, lip-sync and streaming avatars are not on the documented tool list, so for talking-head or dubbing work heygen or sync-labs reach further. Face swap is the headline capability and the docs say nothing about consent — swapping a real person's likeness needs their release and a platform-policy check before it goes anywhere near a cut. Generation spends AKOOL account credits; account_credit reports the balance.

## Verification

- Status: Freshly checked (checked today)
- Added: 2026-10-04
- Last verified: 2026-10-04
- Machine JSON: https://mcp.film/api/mcps/akool.json

## Links

- Site: https://akool.com/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=akool%3Asite
- Docs: https://docs.akool.com/mcp-server?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=akool%3Adocs

---

Structured data: https://mcp.film/api/mcps/akool.json · Directory: https://mcp.film
Canonical: https://mcp.film/mcps/akool/
Hosted directory MCP: https://mcp.film/mcp