How to Install the Travel Animator MCP Server : 2026 Guide
Describe your trip. Let your AI assistant build the route video. This guide takes you from installing the MCP server to rendering your first MP4.

In this article 10 sections
If you’ve already been using Claude, Cursor, or some other MCP-compatible assistant, you’ve probably noticed how much friction disappears once a tool is wired in directly through MCP instead of living in a separate app. That’s exactly what the Travel Animator MCP server does for route videos – instead of opening the mobile app, tapping through stops, and picking a vehicle by hand, you just tell your assistant what you want and it handles the pipeline: planning the route, styling the animation, and rendering the final MP4, all from a normal conversation.
New to making travel animations? Start with the Travel Animator app walkthrough, then explore a step-by-step travel animation guide, then explore in-app video tutorials for more guidance as you set up your workflow.
This guide walks through the full setup from scratch, plus a few things that tend to trip people up the first time
Who This Is Actually For
Before you install anything, it’s worth being honest about whether MCP is the right fit for how you work. If you’re already comfortable in a terminal and you’d rather describe a trip in plain language than click through a UI, this is going to feel natural almost immediately. But if you like seeing the route as you build it, previewing stops visually, or you’re making a longer film that needs footage and narration layered in afterward, you might actually get more out of the mobile app and just export the clip into a proper video editor. There’s no wrong answer here – it really just depends on whether you think in commands or in screens.
How To Install
Start by installing Python 3.12 or newer before starting. Setup time depends on your computer and MCP client
Step 1:Install the Package With The MCP
Install the mcp to include the MCP SDK. Stable releases no longer need the pre-release flag.
Terminal :
pip install "travel-animator[mcp]"Step 2: Sign In to Your Travel Animator Account
travel-animator loginStep 3: Point Your AI Client at the Server
Add the server to your client’s MCP configuration and restart it. Then just ask for a video – the assistant can call auth_status to confirm you’re signed in before it starts building a trip.
MCP client config
{
"mcpServers": {
"travel-animator-mcp": {
"command": "travel-animator",
"args": ["mcp"]
}
}
} Check MCP Installation Status
This opens a status screen. Look for two things:
Status: ✓ connected – this means it worked
Tools: 43 tools – this is the number of tools the server loaded in
If you see both, you’re all set and ready to start asking for videos. If it says anything other than connected, you’ll also see options right there to reconnect or check the tool list, so you can fix it before you even try running a real request.
A Few Prompts to Try Once It's Connected
If you want to sanity-check that everything’s working, these are good ones to start with:
- Animate my Tokyo → Kyoto → Osaka trip as a plane route and render it in 1080p.
- Plan a road-trip route from Dubai to Muscat and give it a cinematic look.
- Re-render that last video with a slower pace and a different vehicle.
- Check whether I’m signed in, then render the bundle I prepared earlier.
How to Render a Route Video with Just a Chat Prompt
Once the Travel Animator MCP server is installed and connected, the actual making a video part is almost anticlimactic – you just type out what you want, hit enter, and wait. No dragging stops around, no clicking through menus. Here’s what that looks like in practice, using a real trip as an example
Step 1: Describe the Trip and the Settings You Want
Just type your route and settings the way you’d explain them to a person.
For example:
Animate my New York→Chicago→Denver→Las Vegas→Los Angeles trip. The settings required for video are:
- Model: Passenger Plane
- Scene style: Follow
- Map style: Terrain
- Place label: Label 5 Black
- Model size: 0.30 (model_size)
- Duration: 25 seconds
That’s the whole prompt. You’re naming your stops in order, picking a vehicle, and listing out a few styling preferences -nothing here requires knowing the underlying tool syntax, since the assistant translates it for you.
A couple of things worth noting if you’re writing your own prompt:
- Order matters for the route, so list your stops in the sequence you actually want animated.
- Be specific about styling if you care about it – scene style, map style, and label formatting all change how the final video looks, so it’s worth spelling these out rather than leaving them to default.
- Duration and model size are just numbers you can adjust freely – there’s no “correct” value, it’s really down to preference.
Step 2: Let It Run
Once you send the prompt, the assistant takes over from there – planning the route, applying your styling, and kicking off the render. You’ll see it log what it’s doing as it goes, including a note when the render task itself completes.
In the example above, it looked like this once finished:
- Render completed successfully, saved locally at a file path like C:\Users\…\Travel Animator\NYC-to-LA-Follow-2026-09-25-…mp4
- It took about 6 minutes, and it used 1 credit
- Most of that time was a slow start before any frames were actually drawn – once rendering began, it moved along normally
This is a good thing to know going in: the first couple of minutes might look like nothing’s happening. That’s normal, not a stuck process.
Step 3: Double-Check the Output Details
Once it’s done, the assistant will usually summarize exactly what was rendered – vehicle, scene style, map style, label style and color, duration, and resolution – so you can confirm it matches what you asked for before you go looking for the file.
One small catch worth knowing: if you paste in a full settings list like the example above, label style (like “Label 5”) applies correctly, but label color (like “Black”) sometimes needs to be set separately rather than picked up automatically from the pasted list. If your labels come out the wrong color, that’s likely why – just call it out explicitly in a follow-up message and it’ll adjust.
What the Finished Video Looks Like
How Long Renders Actually Take
Render times aren’t fixed, and it’s worth setting expectations here rather than assuming something’s broken if it takes a few minutes. In the example used earlier in this post, a 25-second video took about 6 minutes total, and most of that was a slow startup before any frames were actually being drawn.
A Few Practical Tips Before You Start
- Start simple. Your first render doesn’t need to be perfect – it’s easier to adjust settings in a follow-up message than to get everything right in one long prompt.
- Keep an eye on credits. Each render uses one, and while re-rendering the same video within an hour won’t cost extra, changing settings and rendering again does count as a new render.
- Don’t panic during the slow start. The first minute or so of a render can look like nothing’s happening. That’s normal.
- Be specific about color, not just style. If label or text color matters to you, call it out directly rather than assuming it’ll be picked up from a general settings list.
Quick Recap
- Type your route and styling preferences as one prompt, in plain language
- Expect a slow first minute or two before frames start rendering – that’s normal
- Each render uses 1 credit, so it’s worth reviewing your prompt before sending it
- Check the output summary against what you asked for, especially label color if you pasted a full settings block
- The finished MP4 gets saved locally, with the file path shown once it’s done
FAQs
What is the Travel Animator MCP server?
It’s a Python package that lets an AI assistant like Claude or Cursor plan a route, style the animation, and render an MP4 on your own computer, all from what you type in chat. You install it once, sign in, and after that you just describe the video you want
Do I need a Travel Animator account to use it?
Yes. You sign in with the same account you use in the mobile app. Free accounts can build projects, but rendering a video needs premium access and credits.
How much does it cost to render a video?
Each video uses one credit. If you re-render the same video within an hour, you won’t be charged again. One thing to know: a credit can still be used if local rendering fails after the video has been prepared.
Which AI assistants work with it?
Any client that supports MCP over stdio. That includes Claude Desktop, Claude Code, and Cursor. The config is the same small JSON block in each one.









