HandlePilot

com.handlepilotPublished by handlepilot.comOfficial publisherv1.0.0Updated Oct 26, 2026

Instagram content hub for your AI agent: competitor research, reel breakdowns, plans and carousels.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & CommerceMedia & Design

Overview

AI-generated overview

Remote Instagram content hub that lets an AI assistant research competitors, break down reels, plan content and build carousels inside HandlePilot.

What you can do
  • Research public Instagram accounts, posts and reels, including bulk scans of up to 20 accounts on paid plans
  • Break down a reel or post into transcript, scenes, hook, structure and music, and read top-performing competitor content
  • Read and save the content strategy, voice guide and creator context for each workspace
  • Create, list and revise carousels in built-in or custom styles
  • Manage the production board and calendar cards, plus the asset library and Reel Maker uploads
  • Serve HandlePilot playbooks as prompts and collect feedback for the team
When to use it
Useful for creators, social media managers and agencies who plan Instagram content and want an assistant to study competitors, analyse reels and draft strategies, scripts and carousels that stay saved in one workspace across sessions.
Requirements
A remote Streamable HTTP endpoint at app.handlepilot.com; no local install or runtime. Sign-in is OAuth in the browser, or a personal token sent as an Authorization Bearer header. A HandlePilot account is required; paid features need a Pro or Studio subscription. Instagram performance numbers need the Instagram connection made in the app.
Before you install
Paid plans cost money (Pro and Studio monthly, prices exclude tax) and free allowances are capped per month. A token or connected app reaches every workspace you manage with your own rights, so revoke it when done. Tools write and delete data in HandlePilot, including plans, carousels, board cards and assets. Tool results are read by your AI provider, and public Instagram data is fetched by HandlePilot on demand.

Installation

In SourceWeft

  1. Open HandlePilot in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.handlepilot%2Fhandlepilot/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

HandlePilot MCP

[MCP Registry]

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

[HandlePilot MCP in 45 seconds: research, plan, make and edit Instagram content from your AI agent]

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.

Free, $0Pro, $50/monthStudio, $200/month
All 8 playbooks, prompts, carousel styles, content plan, voice guide, creator contextIncludedIncludedIncluded
New video watches a month (watching a video again is free)35003,000
Tool calls a month20,00020,000120,000
Instagram lookups a month (accounts, posts, search)30Within tool callsWithin tool calls
Workspaces (Instagram accounts you manage)120120
Inspiration accounts per workspace5, added by handUnlimited, plus bulk research scansUnlimited, plus bulk research scans
Carousels a month5, in 60+ built-in stylesUnlimited, plus custom stylesUnlimited, plus custom styles
Production board and calendarIn the appIncludedIncluded
Asset library and uploadsIncludedIncluded
Reels (Reel Maker, finished-reel uploads)IncludedIncluded

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)

[Add to Claude]

  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

bash
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, ...):

text
/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

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

Or in ~/.codex/config.toml:

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

then run codex mcp login handlepilot.

Cursor

[Install in Cursor]

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

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

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

VS Code

[Install in VS Code]

Or from a terminal:

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

Or in .vscode/mcp.json:

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.
bash
# Claude Codeclaude mcp add --transport http handlepilot https://app.handlepilot.com/mcp \  --header "Authorization: Bearer hp_YOUR_TOKEN"
toml
# 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"
json
// 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

ToolWhat it does
list_workspacesThe Instagram accounts you manage in HandlePilot
get_creator_contextProfile, niche, audience language, voice guide and samples, plan and board summary. Read first
update_voice_packSave how the creator talks and writes
get_my_performanceThe creator's own 30-day Instagram numbers (needs the Instagram connection made in the app)
list_inspiration_accountsThe competitor and inspiration watch-list, best first
verify_inspiration_accountsMark accounts on the list as verified, on your word
remove_inspiration_accountTake an account off the list
list_top_contentThe best recent posts across the watch-list, with cached video breakdowns inline
get_content_plan, save_content_planRead or save the content strategy
list_carousel_styles, get_carousel_styleHandlePilot's carousel designs and the writing brief for each
list_carousels, get_carousel, update_carouselYour carousels; revise a deck
get_playbookHandlePilot's how-to guides (the same texts as the plugin's skills)
send_feedbackTell the HandlePilot team what to fix, add or change

Free, within the monthly allowances

ToolWhat it doesFree allowance
watch_videoA structured breakdown of a reel, a post or an asset: transcript, on-screen text, scenes, hook, structure, music, editing, why it works3 new videos a month; watching again is free
get_instagram_accountA public profile and its recent posts with numbers30 lookups a month, shared by these three tools
get_instagram_postOne post: caption, numbers, author, media links
search_instagramSearch Instagram profiles, or this month's reels on a topic
create_workspaceAdd an Instagram account as a workspace1 workspace
add_inspiration_accountsAdd accounts to the watch-list for you to verifyUp to 5 per workspace
create_carouselWrite a carousel into a style, editable in the Carousel Maker5 a month, built-in styles

Paid plan

ToolWhat it does
scan_instagram_accountsBulk research: screen up to 20 accounts in one call
list_cards, get_card, create_card, update_card, delete_cardThe production board and calendar, scripts included
create_custom_styleDesign a carousel style of your own, plus its first deck
list_assets, search_assets, get_asset, import_asset_from_url, create_upload_linkThe asset library, searchable by meaning; an upload page for files too big for the chat
start_asset_uploadUpload a file from your computer into the asset library *
list_reels, start_reel_uploadThe Reel Maker, and finished reels your agent cut *

* start_asset_upload and start_reel_upload are offered only to agents that run on your computer, such as Claude Code. Chat apps such as ChatGPT and claude.ai don't get them.

The server also serves its playbooks as MCP prompts: getting-started, strategy, discovery, voice-pack, remix, carousel, custom-style, reel-editing.

Example prompts

  • "Look up @yourhandle on HandlePilot and tell me which of my last 30 posts beat my usual views, and why."
  • "Watch this reel and break down the hook, the structure and why it works: https://www.instagram.com/reel/..."
  • "Build my voice guide from my recent posts and save it to HandlePilot."
  • "Write a 7-slide carousel about meal prep for busy parents in one of HandlePilot's styles, in my voice."
  • "Study my competitors and write me a content strategy for the next month."
  • Paid plan: "Find 25 accounts in my niche I should learn from and add them to my inspiration list."
  • Paid plan: "Turn the strongest idea from my plan into a ready-to-shoot script on my board for next Tuesday."

The Claude Code plugin

plugins/handlepilot/ is a Claude Code plugin, listed in this repository's marketplace (.claude-plugin/marketplace.json). It declares the remote server in .mcp.json and turns HandlePilot's playbooks into eight skills: getting-started, strategy, discovery, voice-pack, remix, carousel, custom-style and reel-editing. It runs no local code. See plugins/handlepilot/README.md.

Your data

  • A connected app or token reaches every workspace you manage, with the same rights as you in the app. Disconnect an app or revoke a token on https://app.handlepilot.com/connect-ai at any time.
  • What a tool returns is read by your agent's AI provider (for example OpenAI for ChatGPT and Codex, Anthropic for Claude), under your agreement with them.
  • Public Instagram data is fetched on demand by HandlePilot. Nothing is posted to Instagram through your agent.
  • Privacy policy: https://handlepilot.com/privacy
  • Terms: https://handlepilot.com/terms

Support

  • Email: [email protected]
  • Bugs and requests: open an issue. Never paste a token (hp_...) into an issue.
  • From your agent: ask it to send feedback; HandlePilot's send_feedback tool reaches the team directly.

License

The files in this repository (docs, server.json, the plugin and its skills) are MIT licensed; see LICENSE. The HandlePilot service is covered by its terms.

HandlePilot is an independent product. It is not affiliated with, endorsed by or sponsored by Instagram or Meta. Instagram is a trademark of Meta Platforms, Inc.

Source: README.md at commit 1db5177

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestOct 26, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts