tegas-mcp

# Tegas MCP Server

Tegas turns an idea into a finished short video. An agent writes a scenario with **Tessa**
(our scenario model), optionally attaches reference images of your product or characters,
generates a 5–60 second video with voice-over, subtitles and music, and can then edit the
result — scenes, voice, subtitles, music, volumes — and rebuild it.

Tegas runs a **hosted remote MCP server**, so there is nothing to install or self-host:

```
https://api.tegas.ai/mcp
```

- Transport: **Streamable HTTP** (stateless)
- Auth: `Authorization: Bearer tg_live_...`
- Russian mirror: `https://api.tegasai.ru`

> This repository holds the **public metadata and documentation** for the Tegas MCP server
> (`server.json`, install instructions, issue tracker). The server implementation itself is
> closed source.

## Prerequisites

1. A Tegas account — sign up at [tegas.ai](https://tegas.ai) (RU: [tegasai.ru](https://tegasai.ru)).
2. **An active paid plan.** Video rendering and hero sheets spend tokens, and the paid tools
   refuse to run without an active plan.
3. An API key: in the Tegas cabinet go to **Settings → API → Create key**. The key looks like
   `tg_live_...`. Treat it like a password.

## Install

### Claude Code

```bash
claude mcp add --transport http tegas https://api.tegas.ai/mcp \
  --header "Authorization: Bearer tg_live_..."
```

### Cursor

Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project):

```json
{
  "mcpServers": {
    "tegas": {
      "url": "https://api.tegas.ai/mcp",
      "headers": {
        "Authorization": "Bearer tg_live_..."
      }
    }
  }
}
```

### VS Code

Add to `.vscode/mcp.json` in your workspace (this keeps the key out of the file by prompting
for it once and storing it in VS Code's secret storage):

```json
{
  "inputs": [
    {
      "id": "tegas-key",
      "type": "promptString",
      "description": "Tegas API key (tg_live_...)",
      "password": true
    }
  ],
  "servers": {
    "tegas": {
      "type": "http",
      "url": "https://api.tegas.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:tegas-key}"
      }
    }
  }
}
```

### Claude.ai custom connector

Tegas is not (yet) in the Claude connectors directory, so add it as a **custom connector**:

1. Open **Settings → Connectors** on [claude.ai](https://claude.ai).
2. Choose **Add custom connector**.
3. URL: `https://api.tegas.ai/mcp`.
4. Under advanced settings, add the header `Authorization` with the value
   `Bearer tg_live_...`.

Custom connectors are available on paid Claude plans. See
[Anthropic's guide to custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## Tools

12 tools. Only two of them ever spend tokens.

| Tool | Cost | What it does |
|---|---|---|
| `tegas_account` | free | balance, plan, limits, price per second of video by quality |
| `tegas_voices` | free | available voices for a language |
| `tegas_upload_reference` | free | uploads one image, returns a `reference_id` |
| `tegas_upload_music` | free | uploads one track, returns a `url` for `tegas_edit_video` |
| `tegas_write_scenario` | free | Tessa writes a scenario from an idea |
| `tegas_find_heroes` | free | brief of characters / hero product, with the price per sheet |
| `tegas_draw_heroes` | **tokens** | draws hero sheets — requires `confirm=true` |
| `tegas_start_video` | **tokens** | starts the render — requires `confirm=true` |
| `tegas_video_status` | free | status of one video |
| `tegas_wait_video` | free | polls every 10 s until completed / failed / timeout |
| `tegas_list_videos` | free | recent videos |
| `tegas_edit_video` | free | edits scenes / voice / subtitles / music / volumes and rebuilds the video |

**Paid tools never spend tokens on the first call.** With `confirm=false` (the default) they
return the price and wait for your consent; only a second call with `confirm=true` charges.
Every render carries an `Idempotency-Key`, so retrying after a timeout never charges twice.
A failed render is refunded.

Current prices are always live from `tegas_account` — check there rather than trusting any
number written down here.

## Example

> Make a 15-second vertical video about a cozy coffee shop in Russian, 720p.
> Show me the scenario and the price first.

## Privacy and data

- The prompts, ideas, reference images and music you pass to the tools are sent to Tegas
  servers to generate and store your videos, and are associated with the account that owns
  the API key.
- Reference images on the hosted connector must be passed as base64 — the connector cannot
  read files from your machine (`file_path` works only on local/self-hosted runs with
  `MCP_ALLOW_LOCAL_FILES=true`).
- Your API key identifies and bills your account. Do not paste it into shared configs or
  commit it to a repository.
- Full details: **[Tegas Privacy Policy](https://tegas.ai/privacy-policy)**
  (RU: [tegasai.ru/privacy-policy](https://tegasai.ru/privacy-policy)) and the
  [terms of offer](https://tegas.ai/offer).

## Docs and support

- Documentation: [docs.tegas.ai](https://docs.tegas.ai)
- Agent-oriented quick reference: [docs.tegas.ai/quickstart.md](https://docs.tegas.ai/quickstart.md)
  (also served to agents as the MCP resource `tegas://quickstart`)
- OpenAPI schema: [api.tegas.ai/v1/openapi.json](https://api.tegas.ai/v1/openapi.json)
- Bugs in this metadata or in the MCP server: [open an issue](https://github.com/ITtegasai/tegas-mcp/issues)

## License

The contents of **this repository** — documentation and metadata only — are released under
the [MIT License](LICENSE). The MIT license covers these files alone. It does **not** apply
to the Tegas MCP server, the Tegas API, or the Tegas service, which are proprietary and
governed by the [terms of offer](https://tegas.ai/offer).