HandlePilot

HandlePilot MCP

An Instagram content hub for your AI agent. Connect Claude, ChatGPT, Claude Code, Codex, Cursor or VS Code to HandlePilot. Your agent researches, plans and writes on your own AI subscription. HandlePilot keeps your workspaces, competitor research, content plan, board, assets, carousels and reels, watches videos for the agent, and holds the editors where you review every word.

• Server: https://app.handlepilot.com/mcp (remote, Streamable HTTP)
• Sign-in: OAuth in your browser (email sign-in link, then Allow), or a personal token
• Docs: https://handlepilot.com/mcp

Watch the demo

Watch the 45-second video on YouTube

This repository holds the public docs, the MCP Registry entry (server.json) and a Claude Code plugin with HandlePilot's playbooks as skills. The server itself is run by HandlePilot and is not in this repository.

What your agent can do

• Research: look up any public Instagram account or post, search profiles and reels, rank what performs for your competitors, and watch reels to get a full breakdown: transcript, scenes, hook, structure, music and why it works.
• Plan: write a content strategy from your arena and your own numbers, save it as your content plan, and put the ideas on your calendar.
• Make: remix proven posts into scripts in your voice, write carousels into HandlePilot's designs (or design a style of your own), and upload reels it cut on your computer.
• Remember: your voice guide, plan, board, assets and decks live in HandlePilot, so every agent session starts from the same place.

Free and paid

Everyone who signs in gets a free account. Nothing runs on your computer and there is no key to copy: the first connection opens a HandlePilot sign-in in your browser.

Plans: handlepilot.com/mcp#plans. Prices exclude tax; cancel anytime.

What a free account can do with the playbooks: write a content strategy and save it as your plan (strategy), build a voice guide from your own captions (voice-pack), break down three new reels a month and remix the best into scripts in your voice (remix), and make five editable carousels a month (carousel). The other playbooks (getting-started, discovery, custom-style, reel-editing) are free to read; a few of their steps use paid tools, and your agent says so.

• Free allowances reset at the start of each calendar month (UTC); paid ones when the subscription renews. Paid plans also carry a fair-use cap on processing that everyday use doesn't reach.
• Every tool is visible on every account. When a tool needs the paid plan, or a free allowance is used up, it answers upgrade_required with a link, and your agent tells you once. Everything you already saved stays usable.
• Upgrade in the app: https://app.handlepilot.com/subscribe. The same connection keeps working; there is nothing to reinstall.

Install

Every client connects to the same URL: https://app.handlepilot.com/mcp.

Claude (claude.ai, Claude Desktop, mobile)

1. Open the link above, or go to Customize → Connectors, select + Add, then Add custom connector. Name it HandlePilot and paste the URL.
2. Select Add, sign in to HandlePilot and press Allow.
3. In a chat, turn it on under + → Connectors.

On Team and Enterprise plans an owner adds it once under Organization settings → Connectors, and each member then selects Connect. On Claude's free plan you can add one custom connector.

ChatGPT

1. Open chatgpt.com/plugins, select +, then Add custom MCP server.
2. Name it HandlePilot, paste the URL, choose OAuth for authentication, accept the warning and select Create as a plugin.
3. Sign in to HandlePilot and press Allow. In a chat, type @ and pick HandlePilot.

Your ChatGPT plan and workspace settings decide whether you can add custom MCP servers.

Claude Code

claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp

Add --scope user to use it in every project. Then type /mcp, pick handlepilot, choose Authenticate, sign in and press Allow.

Or install the plugin, which adds the same server plus HandlePilot's playbooks as skills (/handlepilot:strategy, /handlepilot:remix, ...):

/plugin install handlepilot --marketplace Handlepilot/instagram-mcp

On Claude Code older than 2.1.275, run /plugin marketplace add Handlepilot/instagram-mcp, then /plugin install handlepilot@handlepilot. Then type /mcp, pick plugin:handlepilot:handlepilot, choose Authenticate, sign in and press Allow.

Use one or the other. With both, Claude Code connects twice and lists every tool twice; remove the manual one with claude mcp remove handlepilot.

Codex

codex mcp add handlepilot --url https://app.handlepilot.com/mcp

codex mcp login handlepilot

Or in ~/.codex/config.toml:

[mcp_servers.handlepilot]

url = "https://app.handlepilot.com/mcp"

then run codex mcp login handlepilot.

Cursor

Or add it to ~/.cursor/mcp.json:

{

"mcpServers": { "handlepilot": { "url": "https://app.handlepilot.com/mcp" } } }

Cursor asks you to sign in to HandlePilot the first time it connects.

VS Code

Or from a terminal:

code --add-mcp '{"name":"handlepilot","type":"http","url":"https://app.handlepilot.com/mcp"}'

Or in .vscode/mcp.json:

{

"servers": { "handlepilot": { "type": "http", "url": "https://app.handlepilot.com/mcp" } } }

VS Code opens the HandlePilot sign-in in your browser on first use.

Other clients

Any MCP client that supports remote Streamable HTTP servers with OAuth can use https://app.handlepilot.com/mcp.

A personal token instead of OAuth

For clients that can't do OAuth, or for scripts:

1. Sign in at https://app.handlepilot.com/connect-ai and create a token. It starts with hp_ and is shown once.
2. Send it as a header: Authorization: Bearer hp_YOUR_TOKEN.

# Claude Code

claude mcp add --transport http handlepilot https://app.handlepilot.com/mcp \ --header "Authorization: Bearer hp_YOUR_TOKEN"

# Codex: put the token in an environment variable, e.g. export HANDLEPILOT_TOKEN="hp_YOUR_TOKEN"

[mcp_servers.handlepilot] url = "https://app.handlepilot.com/mcp" bearer_token_env_var = "HANDLEPILOT_TOKEN"

// Cursor: ~/.cursor/mcp.json

{ "mcpServers": { "handlepilot": { "url": "https://app.handlepilot.com/mcp", "headers": { "Authorization": "Bearer hp_YOUR_TOKEN" } } } }

A token reaches every workspace you manage, with the same rights as you in the app. Revoke it on the same page at any time; it stops working at once.

Tools

39 tools. Every account sees all of them; the plan decides which ones run.

Free

Free, within the monthly allowances

Paid plan

| list_assets, search_assets, get_asset, import_asset_from_url, create_upload_link | The asset library, searchable by meaning; an upload page for files too big for