get_async_invoke
Get detailed information about a specific async video generation invocation.
LABSCO SUMMARY
Generation is asynchronous by design, so most of this tool set exists to stop you losing track of the job you started.
start_async_invoke returns immediately and the remaining tools answer what happened afterwards: list_async_invokes for everything tracked with its status, get_async_invoke for one in detail. That is the right shape for video, where a blocking call would simply time out. get_prompting_guide is the unusual inclusion and probably the one most likely to change your output, because it puts the model's own prompting conventions in front of the caller instead of leaving them to be discovered through failed generations. The seed parameter is what makes a run repeatable, which matters when a prompt is being iterated rather than sampled.
What it is
An Amazon Nova Reel client with four tools: start an asynchronous generation, list tracked invocations, read one in detail, and fetch the prompting guide.
What you get
- Generation as an asynchronous job: start_async_invoke takes the prompt with a task_type, dimension, duration_seconds, fps and seed, and returns rather than blocking on the render.
- Job tracking: list_async_invokes returns every tracked invocation with its current status, and get_async_invoke returns one in detail by identifier.
- The guidance in-band: get_prompting_guide returns Nova Reel prompting best practice with examples, so a prompt can be written against the model's own guidance.
Requirements
AWS credentials and an S3 bucket for the output — the server takes an access key id, a secret access key and a bucket name at startup.
Setup effort
One command plus a key — docker pull ghcr.io/mirecekd/novareel-mcp:latest-stdio, then supply credentials
USE CASES
01
Generating a short video clip from a prompt
Read the prompting guidance first, start the generation with its dimension, duration and fps, then check the invocation until it is done.
02
Keeping track of generations you have running
List everything being tracked with its current status, then open the one that finished or failed.
03
Iterating a prompt while holding everything else constant
Fix the seed so the run is repeatable, change only the wording, and compare against the guidance to see which convention moved the result.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_prompting_guide
Get comprehensive prompting guidelines for Amazon Nova Reel video generation.
Returns: Dict containing prompting best practices and examples
list_async_invokes
List all tracked async video generation invocations.
Returns: Dict containing list of all invocations with their current status
start_async_invoke
Start asynchronous video generation with Amazon Nova Reel.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. start_async_invoke generates the video; get_async_invoke returns its URL. list_async_invokes shows only jobs from the current process, since jobs are lost on restart.
Requires
- Python 3.8+
- AWS_ACCESS_KEY_ID in your environment
- AWS_SECRET_ACCESS_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
docker pull ghcr.io/mirecekd/novareel-mcp:latest-stdioMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"novareel-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mirecekd/novareel-mcp:latest-stdio",
"--aws-access-key-id",
"<YOUR_AWS_ACCESS_KEY_ID>",
"--aws-secret-access-key",
"<YOUR_AWS_SECRET_ACCESS_KEY>",
"--s3-bucket",
"<YOUR_S3_BUCKET_NAME>"
]
}
}
}Cline
CLINE · JSON
{
"mcpServers": {
"Nova Reel Video MCP": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mirecekd/novareel-mcp:latest-stdio",
"--aws-access-key-id",
"<YOUR_AWS_ACCESS_KEY_ID>",
"--aws-secret-access-key",
"<YOUR_AWS_SECRET_ACCESS_KEY>",
"--s3-bucket",
"<YOUR_S3_BUCKET_NAME>"
]
}
}
}Any MCP client — uvx
ANY MCP CLIENT — UVX · JSON
{
"mcpServers": {
"novareel-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/mirecekd/novareel-mcp.git",
"novareel-mcp-server",
"--aws-access-key-id",
"<YOUR_AWS_ACCESS_KEY_ID>",
"--aws-secret-access-key",
"<YOUR_AWS_SECRET_ACCESS_KEY>",
"--s3-bucket",
"<YOUR_S3_BUCKET_NAME>"
]
}
}
}
