
Instagram MCP server for Claude, ChatGPT, Cursor and other AI agents: competitor research, reel
Instagram MCP server for Claude, ChatGPT, Cursor and other AI agents: competitor research, reel breakdowns, content plans and editable carousels. By HandlePilot.
·
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.
https://app.handlepilot.com/mcp (remote, Streamable HTTP)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.
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, $0 | Pro, $50/month | Studio, $200/month | |
|---|---|---|---|
| All 8 playbooks, prompts, carousel styles, content plan, voice guide, creator context | Included | Included | Included |
| New video watches a month (watching a video again is free) | 3 | 500 | 3,000 |
| Tool calls a month | 20,000 | 20,000 | 120,000 |
| Instagram lookups a month (accounts, posts, search) | 30 | Within tool calls | Within tool calls |
| Workspaces (Instagram accounts you manage) | 1 | 20 | 120 |
| Inspiration accounts per workspace | 5, added by hand | Unlimited, plus bulk research scans | Unlimited, plus bulk research scans |
| Carousels a month | 5, in 60+ built-in styles | Unlimited, plus custom styles | Unlimited, plus custom styles |
| Production board and calendar | In the app | Included | Included |
| Asset library and uploads | Included | Included | |
| Reels (Reel Maker, finished-reel uploads) | Included | Included |
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.
upgrade_required with a link, and your agent tells you once. Everything you already saved stays usable.Every client connects to the same URL: https://app.handlepilot.com/mcp.
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.
Your ChatGPT plan and workspace settings decide whether you can add custom MCP servers.
claude mcp add --transport http handlepilot https://app.handlepilot.com/mcpAdd --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-mcpOn 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 mcp add handlepilot --url https://app.handlepilot.com/mcp
codex mcp login handlepilotOr in ~/.codex/config.toml:
[mcp_servers.handlepilot]
url = "https://app.handlepilot.com/mcp"then run codex mcp login handlepilot.
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.
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.
Any MCP client that supports remote Streamable HTTP servers with OAuth can use https://app.handlepilot.com/mcp.
For clients that can't do OAuth, or for scripts:
hp_ and is shown once.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.
39 tools. Every account sees all of them; the plan decides which ones run.
Free
| Tool | What it does |
|---|---|
list_workspaces | The Instagram accounts you manage in HandlePilot |
get_creator_context | Profile, niche, audience language, voice guide and samples, plan and board summary. Read first |
update_voice_pack | Save how the creator talks and writes |
get_my_performance | The creator's own 30-day Instagram numbers (needs the Instagram connection made in the app) |
list_inspiration_accounts | The competitor and inspiration watch-list, best first |
verify_inspiration_accounts | Mark accounts on the list as verified, on your word |
remove_inspiration_account | Take an account off the list |
list_top_content | The best recent posts across the watch-list, with cached video breakdowns inline |
get_content_plan, save_content_plan | Read or save the content strategy |
list_carousel_styles, get_carousel_style | HandlePilot's carousel designs and the writing brief for each |
list_carousels, get_carousel, update_carousel | Your carousels; revise a deck |
get_playbook | HandlePilot's how-to guides (the same texts as the plugin's skills) |
send_feedback | Tell the HandlePilot team what to fix, add or change |
Free, within the monthly allowances
| Tool | What it does | Free allowance |
|---|---|---|
watch_video | A structured breakdown of a reel, a post or an asset: transcript, on-screen text, scenes, hook, structure, music, editing, why it works | 3 new videos a month; watching again is free |
get_instagram_account | A public profile and its recent posts with numbers | 30 lookups a month, shared by these three tools |
get_instagram_post | One post: caption, numbers, author, media links | |
search_instagram | Search Instagram profiles, or this month's reels on a topic | |
create_workspace | Add an Instagram account as a workspace | 1 workspace |
add_inspiration_accounts | Add accounts to the watch-list for you to verify | Up to 5 per workspace |
create_carousel | Write a carousel into a style, editable in the Carousel Maker | 5 a month, built-in styles |
Paid plan
| Tool | What it does |
|---|---|
scan_instagram_accounts | Bulk research: screen up to 20 accounts in one call |
list_cards, get_card, create_card, update_card, delete_card | The production board and calendar, scripts included |
create_custom_style | Design a carousel style of your own, plus its first deck |
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 the chat |
start_asset_upload | Upload a file from your computer into the asset library * |
list_reels, start_reel_upload | The 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.
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.
hp_...) into an issue.send_feedback tool reaches the team directly.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.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add handlepilot --transport http https://app.handlepilot.com/mcp{
"mcpServers": {
"handlepilot": {
"url": "https://app.handlepilot.com/mcp"
}
}
}code --add-mcp '{"name":"handlepilot","url":"https://app.handlepilot.com/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/handlepilot-mcp to learn what the "HandlePilot MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http handlepilot https://app.handlepilot.com/mcpThis server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/handlepilot-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "handlepilot-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.