Source: https://polysh.io/agents/mcp/

> **Reading this as an agent?** This is the Markdown copy of a polysh.io page, written for people and agents alike. To learn what Polysh can do for you and your user, start at https://polysh.io/agents/, and use https://polysh.io/llms.txt for an index of every page. Agent features are in early access, so there's nothing to install yet; your user can join the waitlist at https://app.polysh.io/waitlist.

Early access MCP server

# Video tools your agent can call over MCP

The Polysh MCP server lets your agent upload a recording, make a narrated video, add languages, export, and share it from the chat you're in.

[Join the agent waitlist](https://app.polysh.io/waitlist)[Already invited? Sign in](https://app.polysh.io/sign-in)

Early access. The tool list is planned and may change.

## Planned MCP tools

Each tool does one job. Tools that change data or spend credits are labeled.

| Tool              | What it does                                                                 | Label        |
| ----------------- | ---------------------------------------------------------------------------- | ------------ |
| `create_upload`   | Uploads a recording, with its click log and narration if you have them       | Changes data |
| `create_video`    | Turns a recording into a narrated, exported video in one call                | Uses credits |
| `get_job`         | Reports a running job's status and progress                                  | Read only    |
| `wait_for_job`    | Waits until a job finishes, then returns the result                          | Read only    |
| `rewrite_script`  | Rewrites the narration in a style you choose, such as shorter or more formal | Changes data |
| `list_voices`     | Lists the voices for each language                                           | Read only    |
| `set_voice`       | Sets a video's voice for one language                                        | Changes data |
| `list_languages`  | Lists the 16 languages Polysh can narrate in                                 | Read only    |
| `translate_video` | Adds languages to a video, each with its own voice                           | Uses credits |
| `export`          | Renders the MP4 and its SRT and VTT captions                                 | Uses credits |
| `get_guide`       | Returns a video's step-by-step guide as Markdown                             | Read only    |
| `get_share_link`  | Creates a share link for a video or guide                                    | Changes data |
| `list_videos`     | Lists videos in your workspace                                               | Read only    |
| `get_credits`     | Shows the workspace's credit balance                                         | Read only    |
| `delete_video`    | Deletes a video from your workspace                                          | Destructive  |

**Works with Claude Code, Codex, and Cursor** Setup steps come with your early-access invite. One-click connectors for Claude and ChatGPT come later.

## Three things to ask for

### Upload, rewrite, and export

```
Upload onboarding-take-3.mp4 to Polysh, rewrite the script in a friendly tone, and export it in English and Japanese.
```

### Check credits before translating

```
Check our Polysh credits, estimate the cost of translating the "Team permissions" video into French and Dutch, and wait for my go-ahead.
```

### Put a guide in your docs

```
Get the guide for the "Connect Slack" video as Markdown and add it to docs/integrations/slack.md in this repo.
```

## Long jobs don't block your agent

Video jobs take a while, so `create_video`, `translate_video`, and `export` return a job ID at once.

1. 1### Start
    It starts the job and returns its ID.

2. 2### Wait
    `wait_for_job` returns the result when it's ready.

3. 3### Or check in
    `get_job` reports progress while your agent keeps working.

## You stay in charge of changes

### Destructive tools are labeled

`delete_video` is marked destructive, so clients that respect the label ask you first.

### You approve credit use

Tools that spend credits show an estimate, and the agent asks before going ahead.

### Your role, your workspace

The server acts with the permissions your role already has.

## MCP server questions

**Do I need the Video agent too?**

No. It works with any recording you already have. Add the [Video agent](https://polysh.io/agents/video-agent/) if you want your agent to make the recording too.

**How does it sign in to Polysh?**

You connect it to your workspace once, and it acts with your role.

**What does it cost?**

Calling the tools is free during early access. Jobs that render or translate use [workspace credits](https://polysh.io/pricing/), charged only when they succeed.

## Give your agent the Polysh tools

Join the agent waitlist, and we'll send setup steps when your team is invited.

[Join the agent waitlist](https://app.polysh.io/waitlist)[Already invited? Sign in](https://app.polysh.io/sign-in)