mikusnuz avatar

Meta

mikusnuz/meta-mcp

A comprehensive wrapper around Meta's social APIs that gives Claude direct publishing and management capabilities for Instagram and Threads. Exposes 57 tools covering the full Instagram Graph API v25.0 and Threads API surface area: publish photos, videos, reels, carousels, and stories with alt text, manage comments and DMs, pull analytics on views and engagement, search hashtags, handle collaboration invites, and cross-post between platforms. Also includes Threads-specific features like polls, GIFs, topic tags, and spoiler flags. Requires business or creator accounts for Instagram, but works with any Threads account. Handles token management and webhook subscriptions too. Reach for this when you need your AI to actually operate your social accounts, not just draft captions.

GitHub stars
31
tools
15
auth
Secret needed
transport
STDIO
env vars
8
last updated
Oct 19, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

wizard_create_sessionCreate a new wizard session to start gathering requirements. Creates an MCP server in gathering_requirements status with an empty chat history. Use wizard_chat to iterate on requirements with the AI, then call wizard_start once the AI indicates readiness. Args: customer_id: Op...1 params

Create a new wizard session to start gathering requirements. Creates an MCP server in gathering_requirements status with an empty chat history. Use wizard_chat to iterate on requirements with the AI, then call wizard_start once the AI indicates readiness. Args: customer_id: Op...

Parameters* required
customer_idvalue
wizard_chatSend a message in the wizard requirements-gathering chat. Iterate on server requirements with the AI until it indicates readiness (is_ready=True). Then call wizard_start with the server_id to kick off tool suggestion. Args: server_id: Server UUID (from wizard_create_session)....2 params

Send a message in the wizard requirements-gathering chat. Iterate on server requirements with the AI until it indicates readiness (is_ready=True). Then call wizard_start with the server_id to kick off tool suggestion. Args: server_id: Server UUID (from wizard_create_session)....

Parameters* required
messagestring
server_idstring
wizard_startTransition from requirements gathering to tool suggestion. The server must be in gathering_requirements state and the AI must have indicated readiness (wizard_chat returned is_ready=True). Tool suggestion runs in the background – poll with wizard_state to check progress. Args:...3 params

Transition from requirements gathering to tool suggestion. The server must be in gathering_requirements state and the AI must have indicated readiness (wizard_chat returned is_ready=True). Tool suggestion runs in the background – poll with wizard_state to check progress. Args:...

Parameters* required
descriptionvalue
server_idstring
technical_detailsvalue
wizard_list_toolsList current tools for a server in the wizard. Args: server_id: Server UUID.1 params

List current tools for a server in the wizard. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_refine_toolsRefine suggested tools with feedback. Triggers LLM refinement in the background. Poll wizard_state for progress. Args: server_id: Server UUID. feedback: Feedback for the LLM to refine tools. tool_ids: Optional list of tool UUIDs to refine. Omit to refine all.3 params

Refine suggested tools with feedback. Triggers LLM refinement in the background. Poll wizard_state for progress. Args: server_id: Server UUID. feedback: Feedback for the LLM to refine tools. tool_ids: Optional list of tool UUIDs to refine. Omit to refine all.

Parameters* required
feedbackstring
server_idstring
tool_idsvalue
wizard_submit_toolsSubmit the selected tools to proceed to env vars step. Unselected tools will be deleted. Args: server_id: Server UUID. selected_tool_ids: List of tool UUIDs to keep.2 params

Submit the selected tools to proceed to env vars step. Unselected tools will be deleted. Args: server_id: Server UUID. selected_tool_ids: List of tool UUIDs to keep.

Parameters* required
selected_tool_idsarray
server_idstring
wizard_suggest_env_varsTrigger environment variable suggestion via LLM. Args: server_id: Server UUID.1 params

Trigger environment variable suggestion via LLM. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_list_env_varsList current environment variables for a server. Args: server_id: Server UUID.1 params

List current environment variables for a server. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_refine_env_varsRefine suggested environment variables with feedback. Triggers LLM refinement in the background. Args: server_id: Server UUID. feedback: Feedback for the LLM to refine env vars.2 params

Refine suggested environment variables with feedback. Triggers LLM refinement in the background. Args: server_id: Server UUID. feedback: Feedback for the LLM to refine env vars.

Parameters* required
feedbackstring
server_idstring
wizard_submit_env_varsSubmit environment variable values. Provide values as a mapping of variable UUID to its value. Args: server_id: Server UUID. values: Dict of env var UUID -> value, e.g. {"uuid1": "sk-abc123"}.2 params

Submit environment variable values. Provide values as a mapping of variable UUID to its value. Args: server_id: Server UUID. values: Dict of env var UUID -> value, e.g. {"uuid1": "sk-abc123"}.

Parameters* required
server_idstring
valuesobject
wizard_set_authSet up bearer token authentication for the server. Generates and returns a Bearer token. Args: server_id: Server UUID.1 params

Set up bearer token authentication for the server. Generates and returns a Bearer token. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_generate_codeTrigger code generation for all tools. Runs in the background. Poll wizard_state to check progress. Args: server_id: Server UUID.1 params

Trigger code generation for all tools. Runs in the background. Poll wizard_state to check progress. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_regenerate_tool_codeRegenerate code for a single tool (synchronous, waits for LLM). Args: server_id: Server UUID. tool_id: Tool UUID to regenerate code for.2 params

Regenerate code for a single tool (synchronous, waits for LLM). Args: server_id: Server UUID. tool_id: Tool UUID to regenerate code for.

Parameters* required
server_idstring
tool_idstring
wizard_deployDeploy the MCP server to the shared runtime. Args: server_id: Server UUID.1 params

Deploy the MCP server to the shared runtime. Args: server_id: Server UUID.

Parameters* required
server_idstring
wizard_stateGet the current wizard state for a server. Use this to poll for background operation completion (tool suggestion, code generation, etc.). Args: server_id: Server UUID.1 params

Get the current wizard state for a server. Use this to poll for background operation completion (tool suggestion, code generation, etc.). Args: server_id: Server UUID.

Parameters* required
server_idstring

Sponsors

Configuration

INSTAGRAM_ACCESS_TOKENsecret

Instagram Graph API access token

INSTAGRAM_USER_ID

Instagram Business/Creator account ID

INSTAGRAM_MESSAGING_ACCESS_TOKENsecret

Page access token for Instagram Messaging with Facebook Login

INSTAGRAM_PAGE_ID

Facebook Page ID linked to the Instagram account for messaging

THREADS_ACCESS_TOKENsecret

Threads API access token

THREADS_USER_ID

Threads user ID

META_APP_ID

Meta App ID for token/webhook tools

META_APP_SECRETsecret

Meta App Secret for token/webhook tools

Readme

English | 한국어

meta-mcp

npm version License: MIT MCP Badge

Full-coverage MCP server for Instagram Graph API (v26.0), Threads API, and Meta platform management.

When to Use

Tell your AI assistant things like:


View the full README on GitHub

Details

Repository
github.com/mikusnuz/meta-mcp
Category
Media & Entertainment
Package
@mikusnuz/meta-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from mikusnuz

Related Media & Entertainment MCP servers

View all
1acedatacloud avatarSeedance by Ace Data Cloudacedatacloud/seedancemcpGenerate Seedance videos with Ace Data Cloud; retrieve the original task for finished video.21stars
2mcpware avatarPagecastmcpware/pagecastRecord any browser page as GIF or video via MCP17stars
3p-poss avatarDJ Claudep-poss/dj-claudeAgents can now live code music for you, themselves, and each other while they work.15stars
4spacefrontiers avatarMachine Libraryspacefrontiers/mcpMachine Library: cited search over papers, books, patents and social posts, with agent comments.0stars
5decibri avatarMcp Listendecibri/mcp-listenGive your AI agents the ability to listen. Microphone capture and speech-to-text.10stars
6roomi-fields avatarosc-bridgeroomi-fields/osc-bridgeOSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.10stars