For agents

Let your own assistant build the video

Connect Claude, ChatGPT, Cursor or any MCP client. It reads the guide, writes the script, narrates it, times the captions, finds the real outlines and saves the scenes. You review and export.

Connect

How to connect your agent

There are two ways. Sign-in is the easiest and needs no token. Use a token only for tools where you set a header yourself.

Server address (the same for every app)

https://mapflyover.com/api/mcp

It is also shown, with a copy button, in Settings under Agent access.

Option 1: sign in (recommended)

For apps with a connector screen, such as Claude and ChatGPT, and any MCP app that supports sign-in.

  1. In your app, add a custom connector (or remote MCP server) and paste the server address above.
  2. Choose to connect or sign in. The app opens a Mapflyover page in your browser.
  3. Sign in to Mapflyover if you are not already, then check the app name and tap Allow.
  4. You are sent back to the app. It is connected. There is no token to copy.

Option 2: a personal access token

For tools where you set a header yourself, such as Claude Code and Cursor, or any app without a sign-in screen.

  1. Sign in to Mapflyover and open Settings, Agent access.
  2. Name the token (for example "Claude Code on my laptop") and tap Create token.
  3. Copy it now. It is shown only once. If you lose it, create a new one.
  4. Add the server to your tool with the header Authorization: Bearer YOUR_TOKEN (examples below).

Per app

Step by step for each app

Menu names can change as these apps are updated. Look for Connectors, Integrations or MCP servers in the app's settings.

Claude (website and desktop app)
  1. Open Settings, then Connectors.
  2. Choose Add custom connector. Name it Mapflyover and paste https://mapflyover.com/api/mcp.
  3. Add it, then choose Connect. Sign in to Mapflyover in the window that opens and tap Allow.
  4. In a new chat, switch the Mapflyover connector on and ask for a video.

Custom connectors may depend on your Claude plan or workspace settings.

ChatGPT
  1. Open Settings and find Connectors (sometimes under Apps or Developer mode, depending on your plan).
  2. Add a custom connector or remote MCP server, paste https://mapflyover.com/api/mcp and choose OAuth if it asks how to sign in.
  3. Connect, sign in to Mapflyover and tap Allow.
  4. Enable the connector in a chat and ask for a video.

Whether custom connectors are available depends on your ChatGPT plan and settings.

Claude Code

With a token, run this in your terminal (replace YOUR_TOKEN):

claude mcp add --transport http mapflyover https://mapflyover.com/api/mcp --header "Authorization: Bearer YOUR_TOKEN"

Or without a token, add the server and sign in when Claude Code asks:

claude mcp add --transport http mapflyover https://mapflyover.com/api/mcp

Then run /mcp inside Claude Code to check the connection or sign in.

Cursor, Claude Desktop and other apps with a config file

Add this to the app's MCP servers settings. It needs Node.js installed and uses a token:

{
  "mcpServers": {
    "mapflyover": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mapflyover.com/api/mcp",
        "--header", "Authorization:Bearer YOUR_TOKEN"
      ]
    }
  }
}

If your app can add a remote server by address and supports sign-in, use Option 1 instead and skip the token.

What you will see when you tap Allow

A Mapflyover page that names the app asking for access and where it will send you back to. You can allow or cancel.

  • ✓Create and edit your Mapflyover projects
  • ✓Write scripts and scenes, and set caption styles
  • ✓Create narration and timed captions for your videos
  • ✕It cannot export videos, see your keys or change your plan.

Staying connected and disconnecting

  • Sign-in access lasts an hour and renews by itself, for up to 60 days without you doing anything. After that the app asks you to connect again.
  • To disconnect an app, open Settings, Agent access, find it under connected apps and tap Disconnect. It stops working at once.
  • Tokens you made yourself are listed there too. Revoke any of them at any time.

First request

Try asking for a video

“Make a 60 second vertical video about the five largest countries in Africa.”
“Make a travel video about a week in Japan, one scene for each city.”
“Make a top 5 video of the highest mountains in Australia, with a stat card for each height.”

The agent reads the built-in guide, creates the project, writes the script, creates the narration and captions, finds the real outlines, saves the scenes and gives you a link. Open the link to review and adjust. Exporting the MP4 is always done by you in the editor.

Worked example

The five largest countries in Africa, end to end

The whole flow with one real request — the worked example from our step-by-step connection guide, which now lives on this page.

Connect Mapflyover in Claude or ChatGPT as above, start a new chat, make sure the connector is switched on, and send: “Make a 45 second vertical Mapflyover video about the five largest countries in Africa, with narration and captions.” Nothing else is needed: no script from you, no list of countries, no files to upload.

The agent writes a short script that names the five countries in size order, records it with a built-in narration voice, and times the captions to the words. It finds the real OpenStreetMap outline for each country, so the shapes on screen are the actual borders, and saves one scene per country with a camera move for each. A few moments later it replies with a link to the project.

Open the link and press play. Suppose one scene sits on its country a moment too long, or you would rather the video linger on the largest country. You can fix either by hand in the editor, adjusting the scene timing or that scene's camera — or go back to the chat and ask the agent to redo that part. When the preview looks right, export the MP4 yourself from the editor. Exporting is always done by you; the agent cannot do it, and cannot spend your plan credits trying.

Claim links

Videos for people who do not have an account yet

Your agent can also make a video for someone else — a client, a friend, a student — who has never used Mapflyover. Instead of a preview link, the agent hands them a claim link.

  1. The agent builds the video and checks the exact frames, as usual.
  2. It calls create_claim_link. The finished projects (up to 10 in one link) move out of your account into a holding area, and the agent gets the claim link.
  3. The person opens the link and sees the videos. No account is needed to look.
  4. They sign up with Google (or sign in) and press Claim these projects.
  5. The projects land in their own library, ready to open, edit and export like any of their videos.

Claim links live 14 days, and each link can be claimed once. Once claimed, the projects belong to that person's account. Claiming is free; the usual plan rules decide exports, as with any project.

Troubleshooting

If something does not work

The app says it cannot connect, or the Mapflyover page says it cannot connect this app

Start the connection again from the app. This page appears when the request is incomplete or expired. Check the address is exactly https://mapflyover.com/api/mcp with no extra characters.

Calls fail with an access token error

A token may have been revoked, or a sign-in connection may have expired or been disconnected. Connect again, or create a new token in Settings, Agent access.

The agent says narration or captions need a key

Narration needs no key. A key is only needed for captions on a recording you made yourself: add your Groq key under Settings, Your AI keys (Groq has a free tier). If narration briefly fails, try again in a minute.

The agent cannot export the video

Exporting is done by you, in the editor. The Free plan exports 2 short 720p videos a month with a small Mapflyover mark; Pro, Studio or the trial week raise the limits. The satellite look needs a free Mapbox public token, added once in Settings.

Too many requests

Requests are rate limited to keep the service fair. Wait a little while and try again.

The agent cannot see Mapflyover after connecting

Start a new chat and switch the Mapflyover connector on in that chat. Chats started before you connected do not pick it up.

Your free account already has a connector

Free Claude and ChatGPT accounts allow only one custom connector. Remove the other one first, or use a paid plan in that app. The limit is theirs, not Mapflyover's.

The agent replaced scenes you liked

When an agent saves scenes, the previous scenes are kept as a backup, so the earlier version is not lost. Ask the agent to restore it, or re-save the version you preferred.

Tools

What the agent can do

Each tool has a description the agent reads, so no extra prompting is needed.

get_instructions

The full guide: workflow, rules, sizes and recipes.

get_templates / build_video

Six video templates (history, top-list, comparison, route, travel, profile). Pick one, then build_video turns your beats and script into timed scenes with camera, fills, stat cards and pictures, and reports anything to fix.

get_props / get_recipe

The library of ready-made pictures and icons, and step-by-step recipes for common video types.

preview_frames

Render the exact frames of the video — real satellite imagery, camera, titles, stat cards and captions at the moments it chooses — so the agent can look at the real result before it asks you to review.

get_scene_schema

JSON Schema and an example for scenes, with every option described.

create_project / list_projects / get_project

Start or find a project and read its script, captions, scenes and checks.

update_project_settings

Aspect ratio, export resolution, location chip and stat card style.

set_script

Save the narration text.

generate_narration

Create the voice with a natural WaveNet voice (no key), in English or another language.

align_captions

Time the captions from the narration word times (no key), or with the person's own Groq key for their own recording.

set_caption_style

Choose a caption preset and adjust any option.

search_stickers

Find flags, landmarks, nature, transport, animals and icons to pop up on a scene.

resolve_locations

Find real outlines and report any uncertain match.

validate_scenes / save_scenes

Check scenes with plain-language fixes, then save them all at once.

update_scene / update_scenes

Change one scene, or several at once (camera, titles, items, timing), without resending the others.

list_assets / add_asset / delete_asset

Manage the library of pictures, SVGs, GIFs and videos, or draw an SVG on the spot.

import_data / delete_dataset

Add a data table to color countries on a map.

get_preview_link

A link for the person to review, adjust and export.

create_claim_link / get_claim_status

Hand finished videos to someone who has no Mapflyover account yet: the projects (1 to 10) move out of your account into a holding area and the person gets a claim link. They open it, sign up with Google and press Claim, and the projects are in their library. The link lives 14 days, and get_claim_status reports whether a bundle was claimed.

Documented properly

Every option, explained

The server hands the agent a complete reference for each scene field, its range and its default, plus recipes for common shapes of video. Sizes for the place chip, stat cards and captions are given separately for vertical and landscape so overlays stay small and readable.

  • ›Camera: pitch, bearing, orbit, speed, flight time
  • ›Boundaries: place kind, country code, radius, custom shape
  • ›Stat cards and facts, with timing
  • ›Caption styles and project settings

Checked before it is saved

Scenes are validated against a schema and a set of checks: gaps, overlaps, missing outlines, scenes that run past the narration. Problems come back in plain language so the agent can fix them and save again. Nothing half-valid reaches your project.

FAQ

About agent access

Does Mapflyover include its own AI?

Yes, in two ways. Built-in Create with AI builds a video from a sentence (3 videos per account). Your own agent over MCP can also build videos for you: it gives your agent the tools and the documentation to do it, so you choose the model and keep the cost under your control.

Which assistants work?

Any client that supports MCP over streamable HTTP: apps with a sign-in screen (Claude and ChatGPT connectors) connect with OAuth, and tools where you set a header (Claude Code, Cursor) can use a personal access token.

Is it safe to give an agent access?

Access only reaches your own projects. Tokens are stored hashed, sign-in access expires after an hour and is renewed automatically, you can disconnect any app or revoke any token in Settings at any time, and requests are rate limited. The agent cannot export or spend plan credits; you review and export yourself.

Can I still edit what the agent made?

Yes. Open the preview link and everything is a normal editable project.

Can an agent make a video for someone who has no account?

Yes. The agent builds and checks the video, then creates a claim link instead of a preview link. The person opens the link and sees the videos, signs up with Google (or signs in) and presses Claim, and the projects appear in their own library, ready to open, edit and export. Claim links live 14 days.

Put your agent to work

Create a free account, add a token, and ask for your first video.