Open MCP Servers
Allows managing Facebook Pages by publishing posts, photos, videos, Reels and Stories, moderating comments, analyzing page and post insights, and handling audience engagement.
Allows starting, scheduling, and ending Facebook Live video broadcasts on a Facebook Page.
Allows posting photos, reels, stories, and carousels to Instagram, managing DMs and broadcast channels, and retrieving account and follower insights.
Allows managing Messenger conversations and settings, including greeting text and reply management.
Provides integration with Meta's platforms and APIs, covering Facebook Pages, Instagram, Threads, Ads Manager, Commerce, Conversions API, audiences, and insights.
Allows publishing text, image, video, GIF, and link posts to Threads, with reply controls and scheduling capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Open MCP Servers Publish a new Instagram post announcing our product launch."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Open MCP Servers
Self-hosted Model Context Protocol connectors for Meta, GitHub, and Delhivery.
The repository is a small npm workspaces monorepo. Each connector is independently installable and owns its source, tests, package metadata, and documentation. Credentials stay in the environment of the server you run; they are not sent to a hosted Open MCP service.
Contents
Related MCP server: Meta Marketing API MCP Server
Connectors
Connector | npm package | What it provides | Runtime notes |
Meta | 200 purpose-built tools for Facebook Pages, Instagram, Threads, Ads Manager, Commerce, Conversions API, audiences, insights, and charts | Stdio package; the root Docker image and Compose file expose this connector over Streamable HTTP | |
Meta Graph | One generic | Stdio package; configured with | |
GitHub | Local GitHub REST, GraphQL, release, tag, asset, and encrypted-secret tools | The npm command is native-only; the published container remains available for Streamable HTTP | |
Delhivery | Delhivery One B2C API request tool with local token injection | Local stdio only; staging by default, production selected explicitly |
Tool availability is permission- and version-dependent. A PAT never grants more access than GitHub or Meta grants to that token.
Meta
The Meta connector covers:
Facebook Pages: publishing, comments, messaging, moderation, events, media, Stories, Reels, Live Video, webhooks, and automated responses.
Instagram: publishing, scheduling, comments, DMs, broadcast channels, discovery, and insights.
Ads Manager: campaigns, ad sets, ads, creatives, targeting, audiences, pixels, Conversions API, A/B tests, and Advantage+ operations.
Threads, Commerce, and chart generation.
Start with the Meta package README and Meta documentation index.
Meta Graph
The Meta Graph package exposes a single low-level escape hatch for Graph API endpoints that do not yet have a purpose-built tool. It supports GET, POST, PATCH, and DELETE requests, injects META_ACCESS_TOKEN server-side, and requires explicit confirmation for mutations.
Install it with:
npm install -g @open-work-org/meta-graph-mcp-serverExample MCP client configuration:
{
"mcpServers": {
"meta-graph": {
"command": "meta-graph-mcp-server",
"env": {
"META_ACCESS_TOKEN": "your_meta_token"
}
}
}
}See the Meta Graph package README for the tool schema and API-version configuration. Multipart uploads, pagination, and asynchronous workflows may still require specialized handling.
GitHub
The GitHub npm package provides one executable:
github-mcp-server— native API-only mode. It exposes the local REST/GraphQL/release/tag/asset/secret tools without starting Docker.
The published container is the same native-only server exposed over Streamable HTTP and does not fetch or start an official upstream binary.
The local GitHub tools include github_rest_api_request and github_graphql escape hatches, so documented endpoints that do not yet have a dedicated tool can still be reached using the PAT. Native helpers cover releases, Git references, release assets, and encrypted Actions, Dependabot, Codespaces, and Agent secrets.
See the GitHub package README, tool guide, and GitHub documentation index.
Delhivery
The Delhivery package exposes delhivery_b2c_api_request for the documented B2C API paths. It injects DELHIVERY_API_TOKEN, fixes the API host to Delhivery staging or production, and requires explicit confirmation for write methods. The package runs locally over stdio and has no HTTP server mode.
See packages/delhivery/README.md for client configuration and usage.
Install a connector
Install only the package you need. Node.js 18 or newer is supported.
Meta (stdio)
npm install -g @open-work-org/meta-mcp-serverExample MCP client configuration:
{
"mcpServers": {
"meta": {
"command": "meta-mcp-server",
"env": {
"META_ACCESS_TOKEN": "your_meta_token"
}
}
}
}Add THREADS_ACCESS_TOKEN when using Threads operations. Meta setup, permissions, token lifetimes, and API guides are documented in packages/meta/docs.
Meta Graph (stdio)
npm install -g @open-work-org/meta-graph-mcp-serverConfigure it with META_ACCESS_TOKEN; no separate OAuth registration is required by this package.
Delhivery (stdio)
npm install -g @open-work-org/delhivery-mcp-serverSet DELHIVERY_API_TOKEN in the MCP client's environment. DELHIVERY_ENV defaults to staging; set it to production only with the corresponding production token.
GitHub (stdio, native API tools)
npm install -g @open-work-org/github-mcp-serverExample MCP client configuration:
{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"
}
}
}
}The npm command uses the local native API tools and does not require Docker.
Run from source
git clone https://github.com/open-work-org/open-mcp-servers.git
cd open-mcp-servers
npm ci
npm run buildRun Meta after building:
META_ACCESS_TOKEN="your_meta_token" npm startRun the GitHub server after building:
GITHUB_PERSONAL_ACCESS_TOKEN="your_github_pat" \
node packages/github/dist/index.jsThe command above supports stdio by default. For Streamable HTTP, set MCP_TRANSPORT=streamable-http:
MCP_TRANSPORT=streamable-http \
GITHUB_PERSONAL_ACCESS_TOKEN="your_github_pat" \
node packages/github/dist/index.jsCopy .env.example for a starting point, but keep the real file out of version control.
Transport options
Stdio
Stdio is the default and is the simplest option for a local MCP client. The client launches the executable and exchanges MCP messages over stdin/stdout. Diagnostics are written to stderr.
Streamable HTTP
The Meta entrypoint can be hosted through the root Dockerfile or Compose configuration:
cp .env.example .env
# Set META_ACCESS_TOKEN and MCP_HTTP_AUTH_TOKEN in .env.
docker compose up -d --build
curl http://localhost:3000/healthzThe default Meta endpoint is http://127.0.0.1:3000/mcp.
The GitHub executable also supports Streamable HTTP:
MCP_TRANSPORT=streamable-http \
MCP_HTTP_HOST=127.0.0.1 \
GITHUB_MCP_HTTP_PORT=3001 \
MCP_HTTP_AUTH_TOKEN="choose-a-long-random-token" \
GITHUB_PERSONAL_ACCESS_TOKEN="your_github_pat" \
node packages/github/dist/index.jsThe default GitHub endpoint is http://127.0.0.1:3001/github/mcp, with a health check at /healthz. For non-loopback hosting, configure MCP_HTTP_AUTH_TOKEN and put the service behind HTTPS. The HTTP bearer token is separate from the GitHub or Meta API token.
See the connector-specific GitHub Streamable HTTP guide and Meta docs for all environment variables and client-specific examples.
Configuration and security
Credentials
Connector | Required server variable | Optional variable |
Meta |
|
|
Meta Graph |
|
|
GitHub |
|
|
Delhivery |
|
|
HTTP | — |
|
Use a fine-grained GitHub PAT with only the repository, organization, and account permissions required by your workflows. Operations such as releases, tags, workflow dispatches, pull-request approvals, package publishing, and organization secrets still depend on the PAT, token type, SSO, organization policy, and the caller's GitHub role.
The connector:
Reads credentials from the server environment (with an optional 1Password CLI fallback configured by the entrypoint).
Does not accept a PAT as a tool argument.
Does not elevate permissions or bypass third-party API policies.
Validates GitHub REST paths as relative API paths and does not forward the PAT to arbitrary hosts.
Encrypts supported GitHub secret values locally with LibSodium before sending them to GitHub; plaintext secret values are not included in API request bodies.
Never commit .env files, PATs, access tokens, secret values, private keys, or customer data. For HTTP deployments, store credentials in the host's secret manager and protect the endpoint with HTTPS and a separate bearer token.
Documentation
Area | Documentation |
Repository documentation index | |
GitHub connector overview and setup | |
GitHub tool discovery and local catalog | |
GitHub encrypted secrets | |
GitHub architecture | |
GitHub release workflow | |
Meta connector overview and setup | |
Meta authentication | |
Meta API guides | |
Meta Graph package | |
Delhivery package |
Repository layout
open-mcp-servers/
├── packages/
│ ├── meta/
│ │ ├── src/ # Meta MCP implementation
│ │ ├── tests/
│ │ ├── docs/
│ │ ├── package.json
│ │ └── README.md
│ ├── meta-graph/
│ │ ├── src/ # Generic Meta Graph API MCP implementation
│ │ ├── tests/
│ │ ├── package.json
│ │ └── README.md
│ ├── delhivery/
│ │ ├── src/ # Local Delhivery B2C MCP implementation
│ │ ├── package.json
│ │ └── README.md
│ └── github/
│ ├── src/ # Unified and API-only GitHub implementation
│ ├── tests/
│ ├── docs/
│ ├── package.json
│ └── README.md
├── .github/workflows/
│ ├── ci.yml # Tests and builds both packages
│ ├── release.yml # Shared v-N release orchestration
│ ├── publish-npm.yml # Reusable npm publishing job
│ └── publish-ghcr.yml # Reusable Meta and GitHub image publishing jobs
├── Dockerfile # Meta Streamable HTTP image
├── Dockerfile.github # GitHub Streamable HTTP image
├── docker-compose.yml # Local Meta HTTP deployment
├── docs/ # Documentation index
├── package.json # Workspace scripts and dependency lock
└── .env.example # Non-secret configuration templateDevelopment
Install dependencies and run the checks from the repository root:
npm ci
npm test
npm run buildUseful focused commands:
npm run build:meta
npm run build:meta-graph
npm run build:delhivery
npm run build:github
npm run test:watch
npm run cleanConnector-specific changes belong under packages//. Add or update a focused test with every behavior change, keep tool schemas strict, and document new configuration or permissions alongside the connector that owns them.
Releases
The repository uses one sequential repository tag, such as v-1 or v-2, for a release event. Package versions remain independent:
@open-work-org/meta-mcp-server is versioned in packages/meta/package.json.
@open-work-org/meta-graph-mcp-server is versioned in packages/meta-graph/package.json.
@open-work-org/delhivery-mcp-server is versioned in packages/delhivery/package.json.
@open-work-org/github-mcp-server is versioned in packages/github/package.json.
Pushing a new v-N tag runs the release workflow. It tests and builds all packages, detects which connector paths changed, publishes only changed npm package versions, publishes the Meta image only when its runtime inputs changed, and creates one GitHub Release with a manifest of the artifacts. An unchanged package is not republished.
Before creating a release tag:
Bump the version of every changed package.
Run npm ci, npm test, and npm run build.
Push the release commit to main.
Create the next unused v-N tag on that commit.
Required repository configuration is documented in GitHub release workflows. The npm publish job expects NPM_TOKEN; GitHub Actions uses its short-lived GITHUB_TOKEN for the GitHub Release and GHCR permissions declared in the workflow.
License
This project is available under the MIT License. Third-party APIs, tokens, quotas, and platform terms remain the responsibility of the operator.
Not affiliated with or endorsed by Meta Platforms, Inc. or GitHub, Inc.
Available Tools
200 toolsmeta_block_userBlock/Unblock User from PageAIdempotent
Blocks or unblocks a user from a Facebook Page. Blocked users cannot post or comment.
Args:
page_id (string): Facebook Page ID
user_id (string): User ID to block/unblock
unblock (boolean): If true, unblocks the user instead
Inputs: page_id (required), user_id (required), unblock.
meta_browse_targeting_categoriesBrowse Targeting CategoriesCRead-onlyIdempotent
Browses all available targeting category types for ad targeting.
Args:
type (string): Category type — adTargetingCategory, adcountry, adlocale, adlanguage
Inputs: type, class, response_format.
meta_check_instagram_containerCheck Instagram Container StatusARead-onlyIdempotent
Checks the publishing status of an Instagram media container (used for reels/videos that need processing).
Args:
container_id (string): Container ID from a publish step
Returns: status_code — IN_PROGRESS, FINISHED, ERROR, EXPIRED.
Inputs: container_id (required), response_format.
meta_check_instagram_publishing_limitCheck Instagram Publishing Rate LimitARead-only
Checks how many of the 100 API-published posts per 24-hour limit have been used.
Args:
ig_account_id (string): Instagram account ID
Returns: Current usage and quota remaining.
Inputs: ig_account_id (required), response_format.
meta_create_adCreate AdA
Creates a new ad within an ad set.
Args:
ad_account_id (string): Ad account ID
adset_id (string): Parent ad set ID
name (string): Ad name
creative_id (string): Ad creative ID (from meta_list_ad_creatives or meta_create_ad_creative)
status (string): ACTIVE or PAUSED (default PAUSED)
Returns the new ad ID.
Inputs: name (required), adset_id (required), creative_id (required), ad_account_id (required), +2 more.
meta_create_ad_creativeCreate Ad CreativeA
Creates an ad creative from an existing Facebook Page post.
Args:
ad_account_id (string): Ad account ID
name (string): Creative name
page_id (string): Facebook Page ID that owns the post
object_story_id (string, optional): Use an existing published post as creative (format: {page_id}_{post_id})
title (string, optional): Ad headline
body (string, optional): Ad body text
image_url (string, optional): Image URL for the creative
link_url (string, optional): Destination URL
Returns the new creative ID.
Inputs: name (required), page_id (required), ad_account_id (required), body, +5 more.
meta_create_ad_labelCreate Ad LabelB
Creates a label for organizing ads, ad sets, or campaigns.
Args:
ad_account_id (string): Ad account ID
name (string): Label name
Inputs: name (required), ad_account_id (required), response_format.
meta_create_ad_ruleCreate Automated Ad RuleA
Creates an automated rule for managing ads, ad sets, or campaigns.
Args:
ad_account_id (string): Ad account ID
name (string): Rule name
evaluation_spec (object): Conditions that trigger the rule (e.g., {"evaluation_type":"TRIGGER","trigger":{"type":"STATS_CHANGE","field":"cost_per_result","value":"5.00","operator":"GREATER_THAN"}})
execution_spec (object): Actions to take (e.g., {"execution_type":"PAUSE"})
schedule_spec (object, optional): When to evaluate (e.g., {"schedule_type":"DAILY"})
Inputs: name (required), ad_account_id (required), execution_spec (required), evaluation_spec (required), +2 more.
meta_create_adsetCreate Ad SetA
Creates a new ad set within a campaign.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
campaign_id (string): Parent campaign ID
name (string): Ad set name
daily_budget (number, optional): Daily budget in cents
lifetime_budget (number, optional): Lifetime budget in cents (requires end_time)
billing_event (string): How you're charged: IMPRESSIONS, LINK_CLICKS, etc.
optimization_goal (string): What to optimize for: REACH, LINK_CLICKS, CONVERSIONS, etc.
targeting (object): Targeting spec JSON. Example: {"geo_locations": {"countries": ["US"]}, "age_min": 18, "age_max": 65}
start_time (string, optional): ISO 8601 start time
end_time (string, optional): ISO 8601 end time (required with lifetime_budget)
status (string): ACTIVE or PAUSED (default PAUSED)
placement_soft_opt_out (string[], optional): Placements to soft opt-out (up to 5% spend may still go to these). Only for Sales/Leads objectives.
Returns the new ad set ID.
Inputs: name (required), targeting (required), campaign_id (required), ad_account_id (required), +9 more.
meta_create_ad_studyCreate A/B Test (Ad Study)A
Creates an A/B test (ad study) to compare campaigns or ad sets.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
name (string): Study name
description (string, optional): Study description
start_time (string): ISO 8601 start time
end_time (string): ISO 8601 end time
type (enum): SPLIT_TEST or HOLDOUT
cells (array): Test cells, each with name, treatment_percentage, and optional campaign_ids/adset_ids
confidence_level (number, default 95): Statistical confidence level (e.g., 90, 95, 99)
Returns: The created study ID.
Inputs: name (required), type (required), cells (required), end_time (required), +5 more.
meta_create_broadcast_channel_pollCreate Broadcast Channel PollA
Creates a poll in an Instagram broadcast channel.
Args:
channel_id (string): Broadcast channel ID
question (string): Poll question
options (string[]): Poll options (2–4 items)
Returns: Poll/message ID.
Inputs: options (required), question (required), channel_id (required).
meta_create_campaignCreate CampaignA
Creates a new campaign in a Meta ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
name (string): Campaign name
objective (string): Campaign objective. Common values: OUTCOME_AWARENESS, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_APP_PROMOTION, OUTCOME_SALES
status (string): ACTIVE or PAUSED (default PAUSED)
daily_budget (number, optional): Daily budget in account currency cents
lifetime_budget (number, optional): Lifetime budget in cents (requires stop_time)
stop_time (string, optional): ISO 8601 end date (required for lifetime budget)
special_ad_categories (string[], optional): Required for housing, employment, credit ads
Note: For OUTCOME_SALES objective, Advantage+ Shopping campaigns are available. These use Meta's AI to optimize targeting and placements automatically. Create a standard campaign first, then use meta_migrate_campaign_to_advantage_plus to convert it.
Returns the new campaign ID.
Inputs: name (required), objective (required), ad_account_id (required), status, +5 more.
meta_create_custom_audienceCreate Custom AudienceA
Creates a new custom audience in a Meta ad account.
Supported types:
CUSTOM: Website visitors (requires Pixel), app activity, or customer list
ENGAGEMENT: People who engaged with your content
VIDEO: People who watched your videos
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
name (string): Audience name
subtype (string): CUSTOM, ENGAGEMENT, VIDEO, WEBSITE, or APP
description (string, optional): Audience description
customer_file_source (string, optional): For CUSTOM type — USER_PROVIDED_ONLY, PARTNER_PROVIDED_ONLY, BOTH_USER_AND_PARTNER_PROVIDED
retention_days (number, optional): Days to retain audience members (1–180)
Returns the new audience ID.
Note: Populating the audience with users is a separate step requiring the Audiences API to upload hashed data or configure a rule.
Inputs: name (required), subtype (required), ad_account_id (required), description, +3 more.
meta_create_custom_conversionCreate Custom ConversionB
Creates a custom conversion for tracking specific actions.
Args:
ad_account_id (string): Ad account ID
name (string): Conversion name
pixel_id (string): Pixel ID to associate with
custom_event_type (string): Event type — CONTENT_VIEW, SEARCH, ADD_TO_CART, ADD_TO_WISHLIST, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, PURCHASE, LEAD, COMPLETE_REGISTRATION, OTHER
rule (string): URL rule as JSON (e.g., {"url":{"i_contains":"thank-you"}})
Inputs: name (required), rule (required), pixel_id (required), ad_account_id (required), +2 more.
meta_create_eventCreate Facebook Page EventA
Creates an event on a Facebook Page.
Args:
page_id (string): Facebook Page ID
name (string): Event name
start_time (string): ISO 8601 datetime (e.g., 2024-06-15T18:00:00-0400)
end_time (string, optional): ISO 8601 datetime
description (string, optional): Event description
place (string, optional): Location name
ticket_uri (string, optional): Ticket URL
Inputs: name (required), page_id (required), start_time (required), place, +4 more.
meta_create_live_videoCreate Facebook Live VideoA
Creates a live video broadcast on a Facebook Page.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
title (string): Title of the live video
description (string, optional): Description of the broadcast
planned_start_time (string, optional): ISO 8601 datetime for scheduled broadcasts
If planned_start_time is provided, the broadcast is created as SCHEDULED_UNPUBLISHED; otherwise it goes LIVE_NOW.
Returns the stream URL and live video ID.
Inputs: title (required), page_id (required), description, response_format, +1 more.
meta_create_lookalike_audienceCreate Lookalike AudienceB
Creates a lookalike audience based on an existing custom audience or page.
Args:
ad_account_id (string): Ad account ID
name (string): Audience name
origin_audience_id (string): Source custom audience ID to base the lookalike on
country (string): ISO 3166-1 alpha-2 country code (e.g., "US", "GB")
ratio (number): Lookalike size as fraction of country population (0.01–0.20, i.e. 1%–20%)
Returns the new lookalike audience ID.
Inputs: name (required), ratio (required), country (required), ad_account_id (required), +2 more.
meta_create_photo_postCreate Facebook Photo PostB
Publishes a photo post to a Facebook Page.
Args:
page_id (string): Facebook Page ID
url (string): Public URL of the image
caption (string, optional): Photo caption/message
published (boolean): Default true
Inputs: url (required), page_id (required), caption, published, +1 more.
meta_create_pixelCreate Meta PixelB
Creates a new Meta Pixel for conversion tracking.
Args:
ad_account_id (string): Ad account ID
name (string): Pixel name
Inputs: name (required), ad_account_id (required), response_format.
meta_create_postCreate Facebook Page PostA
Creates a new post on a Facebook Page.
Requires: meta_list_pages must be called first to load page tokens.
Args:
page_id (string): Facebook Page ID to post to
message (string): Text content of the post
link (string, optional): URL to attach to the post (creates a link preview)
published (boolean, optional): If false, saves as draft. Default true.
scheduled_publish_time (number, optional): Unix timestamp for scheduling (must be 10 min to 30 days in future; published must be false)
Returns: Post ID of the created post.
Notes:
Maximum post length: ~63,206 characters
Scheduling requires the page to have Page Publishing Authorization
Inputs: message (required), page_id (required), link, published, +2 more.
meta_create_productCreate ProductA
Adds a product to a catalog.
Args:
catalog_id (string): The catalog ID
name (string): Product name
description (string): Product description
price (number): Price in cents
currency (string): Currency code (default "USD")
availability (enum): "in stock", "out of stock", "preorder", "available for order"
image_url (string): Product image URL
url (string): Product page URL
brand (string, optional): Brand name
category (string, optional): Product category
retailer_id (string): Your unique product ID
Returns the created product ID.
Inputs: url (required), name (required), price (required), image_url (required), +8 more.
meta_create_product_feedCreate Product FeedA
Creates a new product feed for a catalog to automatically sync products from a URL.
Args:
catalog_id (string): Product catalog ID
name (string): Feed name
schedule_url (string): URL of the product feed file (CSV, TSV, XML)
schedule_interval (string): How often to fetch — HOURLY, DAILY, WEEKLY, MONTHLY
Returns the new feed ID.
Inputs: name (required), catalog_id (required), schedule_url (required), schedule_interval (required), +1 more.
meta_create_saved_audienceCreate Saved AudienceC
Creates a saved audience (reusable targeting preset) for an ad account.
Args:
ad_account_id (string): Ad account ID
name (string): Audience name
targeting (object): Targeting spec object
Inputs: name (required), targeting (required), ad_account_id (required), response_format.
meta_create_video_postCreate Facebook Video PostC
Publishes a video post to a Facebook Page.
Args:
page_id (string): Facebook Page ID
file_url (string): Public URL of the video file
title (string, optional): Video title
description (string, optional): Video description
Inputs: page_id (required), file_url (required), title, description, +1 more.
meta_cross_postCross-Post to Facebook Page & InstagramA
Publishes the same content to both a Facebook Page and Instagram simultaneously.
Requires: meta_list_pages must be called first to load page tokens.
Args:
page_id (string): Facebook Page ID
ig_account_id (string): Instagram professional account ID
message (string): Text content (used as FB post text and IG caption)
image_url (string, optional): Public image URL — creates photo posts on both platforms
video_url (string, optional): Public video URL — creates Reels on both platforms
Logic:
If image_url: FB photo post + IG photo post (parallel)
If video_url: FB Reel + IG Reel (parallel)
If text only: FB text post only (IG doesn't support text-only posts)
Uses Promise.allSettled so one platform failing doesn't block the other
Returns: Results from both platforms (which succeeded, which failed).
Inputs: message (required), page_id (required), ig_account_id (required), image_url, +2 more.
meta_debug_tokenDebug Access TokenARead-onlyIdempotent
Inspects the current Meta access token to show its type, expiry, permissions, and associated app/user.
Useful for diagnosing "permission denied" errors or checking when a token expires.
No arguments needed — inspects the META_ACCESS_TOKEN configured in your MCP env.
Inputs: response_format.
meta_delete_adDelete AdADestructive
Deletes an ad permanently.
Args:
ad_id (string): Ad ID to delete
Inputs: ad_id (required).
meta_delete_ad_ruleDelete Automated Ad RuleADestructive
Deletes an automated ad rule.
Args:
rule_id (string): Ad rule ID
Inputs: rule_id (required).
meta_delete_adsetDelete Ad SetADestructive
Deletes an ad set permanently.
Args:
adset_id (string): Ad set ID to delete
Inputs: adset_id (required).
meta_delete_campaignDelete CampaignADestructive
Deletes (archives) a campaign. This cannot be undone.
Args:
campaign_id (string): Campaign ID to delete
Inputs: campaign_id (required).
meta_delete_commentDelete Facebook CommentADestructive
Deletes a comment on a Facebook Page post. Permanent action.
Args:
comment_id (string): Comment ID to delete
page_id (string): Page ID (for authentication)
Inputs: page_id (required), comment_id (required).
meta_delete_custom_audienceDelete Custom AudienceADestructive
Deletes a custom audience permanently. This cannot be undone.
Args:
audience_id (string): Custom audience ID to delete
Inputs: audience_id (required).
meta_delete_instagram_commentDelete Instagram CommentADestructive
Deletes a comment on an Instagram media object. This is permanent.
Args:
comment_id (string): The comment ID to delete
Inputs: comment_id (required).
meta_delete_instagram_mediaDelete Instagram MediaADestructive
Deletes an Instagram media object (post, reel, story). This is permanent.
Args:
media_id (string): Instagram media ID to delete
Inputs: media_id (required).
meta_delete_pixelDelete Meta PixelADestructive
Deletes a Meta Pixel.
Args:
pixel_id (string): Pixel ID to delete
Inputs: pixel_id (required).
meta_delete_postDelete Facebook Page PostADestructive
Deletes a post from a Facebook Page. This action is permanent and cannot be undone.
Args:
post_id (string): The post ID to delete (format: {page_id}_{post_id})
page_id (string): The Page ID (for authentication)
Inputs: page_id (required), post_id (required).
meta_delete_productDelete ProductADestructive
Deletes a product from a catalog.
Args:
product_id (string): The product ID
This action is permanent and cannot be undone.
Inputs: product_id (required).
meta_delete_saved_audienceDelete Saved AudienceCDestructive
Deletes a saved audience.
Args:
audience_id (string): Saved audience ID
Inputs: audience_id (required).
meta_end_live_videoEnd Facebook Live VideoAIdempotent
Ends an active live video broadcast.
Requires: meta_list_pages called first to load page tokens.
Args:
live_video_id (string): The live video ID to end
page_id (string): Facebook Page ID (needed for page token auth)
Ends the broadcast immediately.
Inputs: page_id (required), live_video_id (required), response_format.
meta_generate_chartGenerate a Chart from DataAIdempotent
Generates a chart image (PNG) from provided data. Uses QuickChart (Chart.js) to render.
Perfect for creating visual reports from Meta insights data. The chart is saved as a PNG file that can be inserted into Word docs, presentations, or shared directly.
Args:
chart_type (string): 'bar', 'line', 'pie', 'doughnut', 'radar', 'polarArea', 'horizontalBar'
title (string): Chart title
labels (string[]): X-axis labels or pie slice labels
datasets (array): One or more datasets, each with:
label (string): Dataset name (e.g., "Impressions")
data (number[]): Data values matching labels
color (string, optional): CSS color (e.g., "#1877F2", "rgba(24,119,242,0.5)")
width (number): Image width in pixels (default: 800)
height (number): Image height in pixels (default: 400)
output_path (string, optional): Save PNG to this path. If omitted, returns the chart URL.
stacked (boolean, optional): Stack bars/lines (default: false)
show_values (boolean, optional): Display data values on the chart (default: false)
Returns: Chart URL or file path. The URL can be opened in a browser or fetched as a PNG.
Example datasets for ad performance: labels: ["Mon","Tue","Wed","Thu","Fri"] datasets: [ { label: "Impressions", data: [1200,1800,1500,2100,1900], color: "#1877F2" }, { label: "Clicks", data: [45,62,51,78,65], color: "#42B72A" } ]
Inputs: title (required), labels (required), datasets (required), width, +6 more.
meta_generate_comparison_chartGenerate a Before/After or A/B Comparison ChartAIdempotent
Generates a side-by-side comparison chart — perfect for comparing two time periods, two campaigns, or A/B test results.
Args:
title (string): Chart title
metrics (string[]): Metric names (y-axis labels)
group_a (object): { label: string, values: number[], color?: string }
group_b (object): { label: string, values: number[], color?: string }
chart_type (string): 'bar' or 'horizontalBar' (default: 'horizontalBar')
width (number): Width in pixels (default: 800)
height (number): Height in pixels (default: 400)
output_path (string, optional): Save PNG to this path
Example — comparing two weeks: title: "This Week vs Last Week" metrics: ["Impressions", "Reach", "Clicks", "Spend"] group_a: { label: "Last Week", values: [12000, 8000, 450, 150] } group_b: { label: "This Week", values: [15000, 10500, 620, 185] }
Inputs: title (required), group_a (required), group_b (required), metrics (required), +5 more.
meta_get_account_insightsGet Ad Account InsightsARead-only
Gets performance insights for a Meta ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
date_preset (string): Date range preset (default: last_30d)
since (string, optional): Custom start date YYYY-MM-DD (overrides date_preset)
until (string, optional): Custom end date YYYY-MM-DD
breakdowns (string[], optional): Segment by age, gender, country, device_platform, placement, etc.
Returns comprehensive metrics including: Performance: impressions, reach, clicks, spend, frequency, unique_clicks, unique_impressions Cost: cpm, cpc, cpp, ctr, cost_per_action_type, cost_per_conversion, cost_per_inline_link_click, cost_per_outbound_click, cost_per_thruplay Engagement: actions, inline_link_clicks, inline_link_click_ctr, inline_post_engagement, outbound_clicks, outbound_clicks_ctr, social_spend Conversions: conversions, conversion_values, purchase_roas Video: video_play_actions, video_avg_time_watched_actions, video_thruplay_watched_actions, video_p25/p50/p75/p95/p100_watched_actions Quality: quality_ranking, engagement_rate_ranking, conversion_rate_ranking
Inputs: ad_account_id (required), since, until, breakdowns, +2 more.
meta_get_adGet Ad DetailsCRead-onlyIdempotent
Gets detailed information about a specific ad.
Args:
ad_id (string): Ad ID
Inputs: ad_id (required), response_format.
meta_get_ad_accountGet Ad Account DetailsARead-onlyIdempotent
Gets detailed information about a specific ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
Inputs: ad_account_id (required), response_format.
meta_get_ad_account_activityGet Ad Account Activity LogARead-only
Gets the activity/change log for an ad account.
Args:
ad_account_id (string): Ad account ID
limit (number): Max results (default 25)
since (string, optional): Start date YYYY-MM-DD
until (string, optional): End date YYYY-MM-DD
Inputs: ad_account_id (required), limit, since, until, +1 more.
meta_get_ad_account_usersGet Ad Account UsersARead-onlyIdempotent
Lists users who have access to an ad account with their roles.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
Inputs: ad_account_id (required), response_format.
meta_get_ad_creativeGet Ad Creative DetailsCRead-onlyIdempotent
Gets detailed information about a specific ad creative.
Args:
creative_id (string): Creative ID
Inputs: creative_id (required), response_format.
meta_get_ad_insightsGet Ad InsightsARead-only
Gets performance insights at the individual ad level.
Args:
ad_account_id (string, optional): All ads in account
campaign_id (string, optional): All ads in campaign
adset_id (string, optional): All ads in ad set
ad_id (string, optional): Specific ad
date_preset (string): Date range preset (default: last_30d)
since / until (string, optional): Custom date range YYYY-MM-DD
breakdowns (string[], optional): age, gender, country, device_platform, etc.
Provide one of: ad_id, adset_id, campaign_id, or ad_account_id.
Inputs: ad_id, since, until, adset_id, +5 more.
meta_get_ad_previewGet Ad PreviewARead-onlyIdempotent
Generates a preview URL for an ad or creative.
Args:
ad_id (string, optional): Existing ad ID
creative_id (string, optional): Creative ID to preview
ad_format (string): Preview format — DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_STORY, RIGHT_COLUMN_STANDARD
Provide either ad_id or creative_id.
Inputs: ad_id, ad_format, creative_id, response_format.
meta_get_ad_ruleGet Ad Rule DetailsARead-onlyIdempotent
Gets details for a specific automated ad rule.
Args:
rule_id (string): Ad rule ID
Inputs: rule_id (required), response_format.
meta_get_adsetGet Ad Set DetailsCRead-onlyIdempotent
Gets detailed information about a specific ad set.
Args:
adset_id (string): Ad set ID
Inputs: adset_id (required), response_format.
meta_get_adset_insightsGet Ad Set InsightsARead-only
Gets performance insights for ad sets.
Args:
ad_account_id (string): Ad account ID (use for all ad sets)
adset_id (string, optional): Specific ad set ID
campaign_id (string, optional): All ad sets in a campaign
date_preset (string): Date range preset (default: last_30d)
since / until (string, optional): Custom date range YYYY-MM-DD
breakdowns (string[], optional): age, gender, country, device_platform, etc.
Provide ad_account_id or campaign_id or adset_id.
Inputs: since, until, adset_id, breakdowns, +4 more.
meta_get_ad_studiesList A/B Tests (Ad Studies)ARead-onlyIdempotent
Lists A/B tests (ad studies) for a Meta ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
limit (number): Max results (1–50, default 10)
Returns: List of studies with name, type, status, dates, and results.
Inputs: ad_account_id (required), limit, response_format.
meta_get_ad_study_resultsGet A/B Test ResultsARead-onlyIdempotent
Gets detailed results of a specific A/B test (ad study).
Args:
study_id (string): The ad study ID
Returns: Study details including winner, confidence level, and per-cell metrics.
Inputs: study_id (required), response_format.
meta_get_blocked_usersGet Blocked UsersARead-onlyIdempotent
Lists users blocked by the Facebook Page.
Args:
page_id (string): Facebook Page ID
Inputs: page_id (required), response_format.
meta_get_broadcast_channel_messagesGet Broadcast Channel MessagesBRead-only
Gets messages in an Instagram broadcast channel.
Args:
channel_id (string): Broadcast channel ID
limit (number): Max messages (1–100, default 20)
after (string, optional): Pagination cursor
Returns: Paginated list of messages with type, content, and timestamps.
Inputs: channel_id (required), after, limit, response_format.
meta_get_campaignGet Campaign DetailsCRead-onlyIdempotent
Gets detailed information about a specific campaign.
Args:
campaign_id (string): Campaign ID
Inputs: campaign_id (required), response_format.
meta_get_campaign_insightsGet Campaign InsightsARead-only
Gets performance insights for campaigns in a Meta ad account.
Args:
ad_account_id (string): Ad account ID
campaign_id (string, optional): Specific campaign ID (omit for all campaigns)
date_preset (string): Date range preset (default: last_30d)
since (string, optional): Custom start date YYYY-MM-DD
until (string, optional): Custom end date YYYY-MM-DD
breakdowns (string[], optional): Segment by age, gender, country, device_platform, etc.
Returns per-campaign spend, impressions, clicks, CTR, and actions.
Inputs: ad_account_id (required), since, until, breakdowns, +3 more.
meta_get_conversation_messagesGet Conversation MessagesARead-only
Gets messages from a specific Page conversation.
Args:
page_id (string): Facebook Page ID (for auth)
conversation_id (string): Conversation ID (from meta_get_page_conversations)
limit (number): Max messages (1–100, default 20)
Inputs: page_id (required), conversation_id (required), after, limit, +1 more.
meta_get_custom_audienceGet Custom AudienceARead-onlyIdempotent
Gets details about a specific custom audience.
Args:
audience_id (string): Custom audience ID
Inputs: audience_id (required), response_format.
meta_get_delivery_estimateGet Delivery EstimateARead-only
Gets delivery estimate for an existing ad set.
Args:
adset_id (string): Ad set ID
Returns: Estimated daily outcomes (reach, impressions, actions) and bid suggestion.
Inputs: adset_id (required), response_format.
meta_get_instagram_account_insightsGet Instagram Account InsightsARead-only
Gets performance insights for an Instagram professional account.
Args:
ig_account_id (string): Instagram account ID
metrics (string[]): Metrics to retrieve. Options: Interactions: accounts_engaged, total_interactions, likes, comments, shares, saves, replies, reposts, reach, views, profile_links_taps, account_repost_count Legacy: impressions (deprecated v22.0+), follower_count, email_contacts, phone_call_clicks, text_message_clicks, get_directions_clicks, profile_views, website_clicks Demographics: engaged_audience_demographics, reached_audience_demographics, follower_demographics, online_followers
Note: account_repost_count (Dec 2025) returns the total number of reposts across the account for the given period.
period (string): 'day', 'week', 'days_28', 'month', 'lifetime' (lifetime only for demographic metrics)
since (string, optional): Start date YYYY-MM-DD
until (string, optional): End date YYYY-MM-DD
breakdown (string, optional): For demographic metrics: 'age', 'city', 'country', 'gender'
timeframe (string, optional): For demographic metrics: 'last_14_days', 'last_30_days', 'last_90_days', 'this_month', 'this_week'
Note: demographic metrics require 100+ followers. online_followers only available for last 30 days.
Inputs: ig_account_id (required), since, until, period, +4 more.
meta_get_instagram_available_catalogsGet Instagram Available CatalogsARead-onlyIdempotent
Lists product catalogs available for Instagram Shopping on a professional account.
Args:
ig_account_id (string): Instagram account ID
Returns: Catalog IDs and names that can be used for product tagging on this account.
Requires: instagram_shopping_tag_products permission.
Inputs: ig_account_id (required), response_format.
meta_get_instagram_broadcast_channelsList Instagram Broadcast ChannelsARead-onlyIdempotent
Lists broadcast channels for an Instagram professional account.
Broadcast channels enable one-to-many messaging from creators/brands to subscribers.
Args:
ig_account_id (string): Instagram account ID
Returns: Channel IDs, names, descriptions, subscriber counts.
Inputs: ig_account_id (required), response_format.
meta_get_instagram_comment_repliesGet Instagram Comment RepliesARead-only
Gets replies to a specific Instagram comment.
Args:
comment_id (string): Parent comment ID
limit (number): Max replies (1–50, default 20)
Inputs: comment_id (required), limit, response_format.
meta_get_instagram_commentsGet Instagram CommentsCRead-only
Gets comments on an Instagram media object.
Args:
media_id (string): Instagram media ID
limit (number): Max comments to return (1–100, default 20)
Inputs: media_id (required), after, limit, response_format.
meta_get_instagram_conversationsList Instagram DM ConversationsBRead-only
Lists Instagram Direct Message conversations.
Args:
ig_account_id (string): Instagram account ID
folder (string): 'inbox' (default), 'spam', or 'general'
limit (number): Max conversations (1–100, default 20)
after (string, optional): Pagination cursor
Requires instagram_manage_messages permission. Uses user token (not page token).
Inputs: ig_account_id (required), after, limit, folder, +1 more.
meta_get_instagram_live_mediaGet Instagram Live MediaBRead-only
Gets live video broadcasts from an Instagram account.
Args:
ig_account_id (string): Instagram account ID
Inputs: ig_account_id (required), response_format.
meta_get_instagram_mediaGet Instagram MediaARead-only
Lists media (posts, reels, stories) from an Instagram professional account.
Args:
ig_account_id (string): Instagram account ID (from meta_list_instagram_accounts)
limit (number): Max items to return (1–100, default 20)
after (string, optional): Pagination cursor
Inputs: ig_account_id (required), after, limit, response_format.
meta_get_instagram_media_childrenGet Instagram Carousel ItemsARead-onlyIdempotent
Gets individual media items in a carousel/album post.
Args:
media_id (string): Carousel media ID
Inputs: media_id (required), response_format.
meta_get_instagram_media_insightsGet Instagram Media InsightsARead-onlyIdempotent
Gets performance metrics for a specific Instagram media object.
Args:
media_id (string): Instagram media ID (from meta_get_instagram_media)
metrics (string[]): Metrics vary by media type: Photos/Carousels: reach, likes, comments, shares, saved, total_interactions, follows, profile_visits, profile_activity, views, impressions (deprecated) Reels/Video: reach, likes, comments, shares, saved, total_interactions, follows, profile_visits, profile_activity, views, ig_reels_avg_watch_time, ig_reels_video_view_total_time, reels_skip_rate, repost_count, crossposted_views, facebook_views, impressions (deprecated), plays (deprecated), clips_replays_count (deprecated) Stories: reach, shares, follows, profile_visits, profile_activity, replies, navigation, total_interactions, views, impressions (deprecated)
New Reels metrics (Dec 2025): - reels_skip_rate: Percentage of viewers who skip within first 3 seconds - repost_count: Number of reposts of this media - crossposted_views: Total views across Instagram and Facebook (for crossposted content) - facebook_views: Facebook-specific views for crossposted Reels
breakdown (string, optional): 'action_type' (for profile_activity) or 'story_navigation_action_type' (for navigation)
Inputs: media_id (required), metrics, breakdown, response_format.
meta_get_instagram_mentioned_mediaGet Instagram MentionsBRead-only
Gets media where the Instagram account was @mentioned in a caption or comment.
Args:
ig_account_id (string): Instagram account ID
limit (number): Max results (default 20)
Requires instagram_manage_comments permission.
Inputs: ig_account_id (required), after, limit, response_format.
meta_get_instagram_messagesGet Instagram DM MessagesARead-only
Gets messages in an Instagram Direct Message conversation.
Args:
conversation_id (string): Conversation ID (from meta_get_instagram_conversations)
limit (number): Max messages (1–100, default 20)
after (string, optional): Pagination cursor
Messages are returned in reverse chronological order from the API and displayed in chronological order.
Inputs: conversation_id (required), after, limit, response_format.
meta_get_instagram_product_tagsGet Instagram Product TagsARead-onlyIdempotent
Gets product tags on an Instagram media object. Requires Instagram Shopping.
Args:
media_id (string): Instagram media ID
Inputs: media_id (required), response_format.
meta_get_instagram_recent_hashtagsGet Recently Searched HashtagsARead-only
Gets hashtags recently searched by the Instagram account.
Args:
ig_account_id (string): Instagram account ID
Note: Limited to 30 unique hashtag searches per 7 days. This returns the recent searches.
Inputs: ig_account_id (required), response_format.
meta_get_instagram_single_mediaGet Single Instagram Media DetailsBRead-onlyIdempotent
Gets detailed information about a specific Instagram media object.
Args:
media_id (string): Instagram media ID
Inputs: media_id (required), response_format.
meta_get_instagram_storiesGet Instagram StoriesARead-onlyIdempotent
Gets currently active stories for an Instagram professional account.
Args:
ig_account_id (string): Instagram account ID
Returns: List of active story media objects. Stories expire after 24 hours.
Inputs: ig_account_id (required), response_format.
meta_get_instagram_userGet Instagram User InfoARead-onlyIdempotent
Gets public profile info for any Instagram business/creator account by username.
Uses the Business Discovery API — no follow/connection required.
Args:
ig_account_id (string): Your Instagram account ID (for auth)
username (string): Instagram username to look up (without @)
Returns: Bio, follower/following counts, media count, profile picture, and recent media.
Inputs: username (required), ig_account_id (required), response_format.
meta_get_leadgen_leadsGet Leads from FormARead-only
Gets submitted leads from a lead generation form.
Requires: meta_list_pages must be called first to load page tokens.
Args:
form_id (string): Lead gen form ID (from meta_list_leadgen_forms)
page_id (string): Page ID (for authentication)
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
Returns lead data including field values, creation time, and ad info.
Inputs: form_id (required), page_id (required), after, limit, +1 more.
meta_get_live_videosList Facebook Live VideosARead-onlyIdempotent
Lists live videos on a Facebook Page.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
broadcast_status (enum, optional): Filter by status — "LIVE", "UNPUBLISHED", "SCHEDULED_UNPUBLISHED", or "VOD"
limit (number, optional): Max results (1–100, default 10)
after (string, optional): Pagination cursor
Returns live video details including title, status, views, and creation time.
Inputs: page_id (required), after, limit, response_format, +1 more.
meta_get_minimum_budgetsGet Minimum Ad BudgetsARead-onlyIdempotent
Gets the minimum daily and lifetime budgets for an ad account by currency and bid strategy.
Essential to check before creating ad sets — using a budget below the minimum causes API errors.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
Returns: Minimum budget requirements per bid strategy.
Inputs: ad_account_id (required), response_format.
meta_get_pageGet Facebook Page DetailsBRead-onlyIdempotent
Gets detailed information about a specific Facebook Page.
Args:
page_id (string): The Facebook Page ID
Returns page details including name, category, description, follower counts, and linked Instagram account.
Inputs: page_id (required), response_format.
meta_get_page_albumsGet Page Photo AlbumsCRead-only
Lists photo albums on a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_page_automated_responsesGet Page Automated Messaging SettingsARead-onlyIdempotent
Gets the current automated messaging settings for a Facebook Page.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
Returns: Instant reply message, away message, greeting text, and ice breakers configuration.
Inputs: page_id (required), response_format.
meta_get_page_conversationsGet Page ConversationsARead-only
Lists conversations (messages) in a Facebook Page inbox.
Args:
page_id (string): Facebook Page ID
limit (number): Max conversations (1–100, default 20)
after (string, optional): Pagination cursor
Requires pages_messaging permission.
Inputs: page_id (required), after, limit, response_format.
meta_get_page_ctaGet Page Call-to-ActionARead-onlyIdempotent
Gets the call-to-action button configured on a Facebook Page.
Args:
page_id (string): Facebook Page ID
Inputs: page_id (required), response_format.
meta_get_page_eventsGet Page EventsARead-only
Lists events created by a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
time_filter (string): 'upcoming' or 'past'
Inputs: page_id (required), limit, time_filter, response_format.
meta_get_page_fan_demographicsGet Page Fan DemographicsARead-onlyIdempotent
Gets fan/follower demographic breakdowns for a Facebook Page via insights.
Args:
page_id (string): Facebook Page ID
metric (string): Demographic metric — 'page_fans_city', 'page_fans_country', 'page_fans_gender_age', 'page_fans_locale'
Inputs: page_id (required), metric, response_format.
meta_get_page_insightsGet Facebook Page InsightsARead-only
Gets analytics/insights for a Facebook Page.
Requires: meta_list_pages called first.
Args:
page_id (string): Facebook Page ID
metrics (string[]): Metrics to retrieve. Full options: Impressions: page_impressions, page_impressions_unique, page_impressions_organic, page_impressions_organic_unique, page_impressions_paid, page_impressions_paid_unique, page_impressions_viral, page_impressions_viral_unique, page_impressions_nonviral, page_impressions_nonviral_unique Post Impressions: page_posts_impressions, page_posts_impressions_unique, page_posts_impressions_organic, page_posts_impressions_organic_unique, page_posts_impressions_paid, page_posts_impressions_paid_unique, page_posts_impressions_viral, page_posts_impressions_viral_unique Engagement: page_engaged_users, page_post_engagements, page_total_actions, page_negative_feedback Reactions: page_actions_post_reactions_total, page_actions_post_reactions_like_total, page_actions_post_reactions_love_total, page_actions_post_reactions_wow_total, page_actions_post_reactions_haha_total, page_actions_post_reactions_sorry_total, page_actions_post_reactions_anger_total Fans: page_fans, page_fan_adds, page_fan_adds_unique, page_fan_adds_by_paid_non_paid_unique, page_fan_removes, page_fan_removes_unique, page_daily_follows, page_daily_follows_unique, page_daily_unfollows_unique Views: page_views_total, page_tab_views_login_top, page_tab_views_login_top_unique, page_tab_views_logout_top Video: page_video_views, page_video_views_unique, page_video_views_paid, page_video_views_organic, page_video_views_autoplayed, page_video_views_click_to_play, page_video_complete_views_30s, page_video_complete_views_30s_unique, page_video_complete_views_30s_paid, page_video_complete_views_30s_organic, page_video_repeat_views, page_video_view_time, page_video_views_10s, page_video_views_10s_unique, page_video_views_10s_paid, page_video_views_10s_organic Content: page_media_view, page_lifetime_engaged_followers_unique
period (string): Aggregation period: 'day', 'week', 'days_28', 'month'
since (string, optional): Start date YYYY-MM-DD
until (string, optional): End date YYYY-MM-DD
Returns: Time-series data for each metric.
Inputs: page_id (required), since, until, period, +2 more.
meta_get_page_locationsGet Page LocationsBRead-onlyIdempotent
Lists location pages for a business with multiple locations.
Args:
page_id (string): Parent Facebook Page ID
Inputs: page_id (required), limit, response_format.
meta_get_page_photosGet Page PhotosBRead-only
Lists photos uploaded to a Facebook Page.
Args:
page_id (string): Facebook Page ID
type (string): 'uploaded' (by page) or 'tagged' (photos page is tagged in)
limit (number): Max results (default 20)
Inputs: page_id (required), type, after, limit, +1 more.
meta_get_page_pictureGet Page Profile PictureBRead-onlyIdempotent
Gets the profile picture URL for a Facebook Page.
Args:
page_id (string): Facebook Page ID
size (string): Picture size — small, normal, large, square (default: large)
Inputs: page_id (required), size, response_format.
meta_get_page_ratingsGet Page Ratings/ReviewsBRead-only
Gets ratings and reviews for a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_page_tabsGet Page TabsARead-onlyIdempotent
Lists custom tabs on a Facebook Page.
Args:
page_id (string): Facebook Page ID
Inputs: page_id (required), response_format.
meta_get_page_taggedGet Page Tagged PostsARead-only
Gets posts that tag this Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_page_videosGet Page VideosCRead-only
Lists videos uploaded to a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_pixelGet Meta Pixel DetailsCRead-onlyIdempotent
Gets details for a single Meta Pixel.
Args:
pixel_id (string): Pixel ID
response_format (optional): "json" or "text"
Inputs: pixel_id (required), response_format.
meta_get_pixel_eventsGet Pixel EventsBRead-onlyIdempotent
Gets recent events received by a pixel (for debugging).
Args:
pixel_id (string): Pixel ID
Inputs: pixel_id (required), response_format.
meta_get_pixel_statsGet Meta Pixel StatsARead-onlyIdempotent
Gets event volume stats for a pixel (critical for verifying pixel is firing).
Args:
pixel_id (string): Pixel ID
start_time (string, optional): ISO date for start of range
end_time (string, optional): ISO date for end of range
aggregation (string, optional): "event" (default) or "device"
event (string, optional): Filter to specific event like "Purchase"
Inputs: pixel_id (required), event, end_time, start_time, +2 more.
meta_get_postGet Single Post DetailsBRead-onlyIdempotent
Gets detailed information about a specific Facebook post.
Args:
post_id (string): Post ID (format: {page_id}_{post_id})
Inputs: post_id (required), response_format.
meta_get_post_commentsGet Post CommentsARead-only
Gets comments on a Facebook Page post.
Args:
post_id (string): Post ID (format: {page_id}_{post_id})
page_id (string): Page ID (for authentication — call meta_list_pages first)
limit (number): Max comments (1–100, default 25)
order (string): 'chronological' or 'reverse_chronological'
after (string, optional): Pagination cursor
filter (string): 'toplevel' (default), 'stream' (all including replies)
Inputs: page_id (required), post_id (required), after, limit, +3 more.
meta_get_post_insightsGet Facebook Post InsightsARead-onlyIdempotent
Gets performance metrics for a specific Facebook Page post.
Requires: meta_list_pages called first.
Args:
post_id (string): Post ID (e.g., "page_id_post_id")
page_id (string): Page ID (for authentication)
metrics (string[]): Metrics to retrieve. Options: Performance: post_impressions, post_impressions_unique, post_impressions_paid, post_impressions_paid_unique, post_impressions_fan, post_impressions_fan_unique, post_impressions_organic, post_impressions_organic_unique, post_impressions_viral, post_impressions_viral_unique Engagement: post_clicks, post_clicks_by_type, post_engaged_users, post_negative_feedback, post_negative_feedback_by_type, post_engaged_fan Reactions: post_reactions_by_type_total, post_reactions_like_total, post_reactions_love_total, post_reactions_wow_total, post_reactions_haha_total, post_reactions_sorry_total, post_reactions_anger_total Media: post_media_view, post_total_media_view_unique Video: post_video_avg_time_watched, post_video_complete_views_organic, post_video_complete_views_paid, post_video_views_organic, post_video_views_paid, post_video_view_time Activity: post_activity_by_action_type, post_activity_by_action_type_unique
All post metrics use 'lifetime' period (cumulative from post creation).
Inputs: page_id (required), post_id (required), metrics, response_format.
meta_get_post_reactionsGet Post ReactionsARead-onlyIdempotent
Gets reaction counts (like, love, haha, wow, sad, angry) on a post.
Args:
post_id (string): Post ID
Inputs: post_id (required), response_format.
meta_get_postsGet Facebook Page PostsARead-only
Lists posts from a Facebook Page feed.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
limit (number): Max posts to return (1–100, default 20)
after (string, optional): Cursor for next page of results
Returns: List of posts with message, permalink, created time, and post ID.
Inputs: page_id (required), after, limit, response_format.
meta_get_productGet ProductARead-onlyIdempotent
Gets details for a single product.
Args:
product_id (string): The product ID
Returns full product details including price, availability, sale price, condition, and inventory.
Inputs: product_id (required), response_format.
meta_get_product_catalogGet Product CatalogBRead-onlyIdempotent
Gets details for a single product catalog.
Args:
catalog_id (string): The catalog ID
Returns catalog name, product count, vertical, business info, and store settings.
Inputs: catalog_id (required), response_format.
meta_get_promotable_postsGet Promotable PostsARead-only
Gets posts that are eligible for boosting/promotion on a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_published_postsGet Published PostsARead-only
Gets posts published by the Page itself (excludes visitor posts, unlike the feed edge).
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_reach_estimateGet Reach EstimateARead-only
Estimates the potential reach for a targeting specification.
Args:
ad_account_id (string): Ad account ID
targeting_spec (object): Targeting specification (same format as ad set targeting)
optimization_goal (string, optional): e.g., REACH, LINK_CLICKS, IMPRESSIONS
Returns: Estimated daily reach and audience size.
Inputs: ad_account_id (required), targeting_spec (required), response_format, optimization_goal.
meta_get_scheduled_postsGet Scheduled PostsBRead-only
Lists scheduled (unpublished) posts for a Facebook Page.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_get_visitor_postsGet Visitor PostsARead-only
Gets posts published by visitors on the Facebook Page wall.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Inputs: page_id (required), after, limit, response_format.
meta_health_checkMeta MCP Health CheckARead-only
Checks the health of the Meta MCP server: token status, cached tokens, API connectivity.
Returns: Token validity, number of cached page tokens, Threads token status, and API reachability.
Inputs: response_format.
meta_hide_commentHide or Unhide a Facebook CommentAIdempotent
Hides or unhides a comment on a Facebook Page post.
Hidden comments are only visible to the comment author and their friends. This is a non-destructive alternative to deletion — useful for moderation.
Args:
comment_id (string): Comment ID to hide/unhide
page_id (string): Page ID (for authentication)
is_hidden (boolean): true to hide, false to unhide
Requires pages_manage_engagement permission.
Inputs: page_id (required), is_hidden (required), comment_id (required).
meta_hide_instagram_commentHide or Unhide an Instagram CommentAIdempotent
Hides or unhides a comment on an Instagram media object.
Hidden comments are only visible to the comment author. This is a non-destructive alternative to deletion — useful for moderation.
Args:
comment_id (string): Comment ID to hide/unhide
is_hidden (boolean): true to hide, false to unhide
Inputs: is_hidden (required), comment_id (required).
meta_like_objectLike/Unlike Post or CommentAIdempotent
Likes or removes a like from a page post or comment, acting as the Page.
Args:
object_id (string): Post ID or Comment ID
page_id (string): Page ID (for token)
unlike (boolean): If true, removes the like instead
Inputs: page_id (required), object_id (required), unlike.
meta_list_ad_accountsList Meta Ad AccountsARead-onlyIdempotent
Lists all Meta ad accounts accessible to the authenticated user.
Returns ad account IDs (prefixed with act_), names, currency, status, and spend info.
Call this first to get ad account IDs needed for campaign and insights tools.
Inputs: response_format.
meta_list_ad_creativesList Ad CreativesARead-only
Lists ad creatives for an ad account.
Args:
ad_account_id (string): Ad account ID
limit (number): Max results (default 20)
after (string, optional): Pagination cursor
Returns creative IDs, names, and associated page post IDs.
Inputs: ad_account_id (required), after, limit, response_format.
meta_list_ad_imagesList Ad ImagesBRead-only
Lists images in an ad account's image library.
Args:
ad_account_id (string): Ad account ID
limit (number): Max results (default 25)
Inputs: ad_account_id (required), after, limit, response_format.
meta_list_ad_labelsList Ad LabelsARead-onlyIdempotent
Lists ad labels for an ad account. Labels help organize campaigns, ad sets, and ads.
Args:
ad_account_id (string): Ad account ID
Inputs: ad_account_id (required), response_format.
meta_list_ad_rulesList Automated Ad RulesARead-onlyIdempotent
Lists automated rules for an ad account.
Args:
ad_account_id (string): Ad account ID
Inputs: ad_account_id (required), response_format.
meta_list_adsList AdsARead-only
Lists ads for an ad set, campaign, or ad account.
Args:
adset_id (string, optional): Filter by ad set
campaign_id (string, optional): Filter by campaign
ad_account_id (string, optional): List all ads in account
status_filter (string[], optional): ACTIVE, PAUSED, ARCHIVED, DELETED
limit (number): Max results (default 20)
after (string, optional): Pagination cursor
Provide one of adset_id, campaign_id, or ad_account_id.
Inputs: after, limit, adset_id, campaign_id, +3 more.
meta_list_adsetsList Ad SetsARead-only
Lists ad sets for a campaign or ad account.
Args:
campaign_id (string, optional): Filter by campaign ID
ad_account_id (string, optional): Ad account ID (use if not filtering by campaign)
status_filter (string[], optional): ACTIVE, PAUSED, ARCHIVED, DELETED
limit (number): Max results (default 20)
after (string, optional): Pagination cursor
Provide either campaign_id or ad_account_id.
Inputs: after, limit, campaign_id, ad_account_id, +2 more.
meta_list_ad_videosList Ad VideosARead-only
Lists videos in an ad account's video library.
Args:
ad_account_id (string): Ad account ID
limit (number): Max results (default 20)
Inputs: ad_account_id (required), after, limit, response_format.
meta_list_business_assetsList Business Manager AssetsBRead-onlyIdempotent
Lists assets (pages, ad accounts, Instagram accounts, pixels) for a Business Manager.
Args:
business_id: Business Manager ID
asset_type: "owned_pages", "owned_ad_accounts", "owned_instagram_accounts", "owned_pixels"
limit (optional, default 25): Max results
Returns asset details including IDs, names, and type-specific metadata.
Inputs: asset_type (required), business_id (required), limit, response_format.
meta_list_campaignsList CampaignsBRead-only
Lists campaigns for a Meta ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
status_filter (string[], optional): Filter by status: ACTIVE, PAUSED, ARCHIVED, DELETED
limit (number): Max results (1–100, default 20)
after (string, optional): Pagination cursor
Returns campaign names, objectives, status, and budget info.
Inputs: ad_account_id (required), after, limit, status_filter, +1 more.
meta_list_custom_audiencesList Custom AudiencesARead-only
Lists custom audiences in a Meta ad account.
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
limit (number): Max results (1–100, default 20)
after (string, optional): Pagination cursor
Returns audience names, types, size estimates, and delivery status.
Inputs: ad_account_id (required), after, limit, response_format.
meta_list_custom_conversionsList Custom ConversionsCRead-onlyIdempotent
Lists custom conversions for an ad account.
Args:
ad_account_id (string): Ad account ID
Inputs: ad_account_id (required), response_format.
meta_list_instagram_accountsList Instagram Business AccountsARead-onlyIdempotent
Lists all Instagram professional accounts linked to the user's Facebook Pages.
Requires: meta_list_pages must be called first.
Returns: Instagram account IDs, usernames, follower counts. The account ID is needed for all other Instagram tools.
Inputs: response_format.
meta_list_leadgen_formsList Lead Gen FormsARead-only
Lists lead generation forms for a Facebook Page.
Lead forms are used with OUTCOME_LEADS campaigns to collect user information.
Requires: meta_list_pages must be called first to load page tokens.
Args:
page_id (string): Facebook Page ID
limit (number): Max results (1–100, default 20)
Returns form IDs, names, status, and creation times.
Inputs: page_id (required), after, limit, response_format.
meta_list_offline_event_setsList Offline Event SetsARead-onlyIdempotent
Lists offline conversion event sets for an ad account.
Offline event sets track conversions that happen outside of digital channels (in-store purchases, phone orders, etc.).
Args:
ad_account_id (string): Ad account ID (e.g., act_123456789)
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
Returns: Event set IDs, names, and configuration.
Inputs: ad_account_id (required), after, limit, response_format.
meta_list_pagesList Facebook PagesARead-onlyIdempotent
Lists all Facebook Pages managed by the authenticated user.
IMPORTANT: Call this tool first before any page or Instagram operations — it caches the page access tokens needed for subsequent calls.
Returns:
id: Page ID (needed for other tools)
name: Page name
category: Page category
fan_count: Number of likes
followers_count: Number of followers
link: Page URL
instagram_business_account.id: Linked Instagram account ID (if any)
Tip: The page tokens are cached automatically. You do not need to manage them manually.
Inputs: response_format.
meta_list_pixelsList Ad Account PixelsBRead-onlyIdempotent
Lists all Meta Pixels for an ad account.
Args:
ad_account_id (string): Ad account ID
Inputs: ad_account_id (required), response_format.
meta_list_product_catalogsList Product CatalogsARead-onlyIdempotent
Lists product catalogs for a Meta business.
Args:
business_id (string): The business ID
limit (number): Max results (1–100, default 25)
Returns catalog IDs, names, product counts, and verticals.
Inputs: business_id (required), limit, response_format.
meta_list_product_feedsList Product FeedsARead-onlyIdempotent
Lists product feeds for a catalog. Feeds are automated data sources that keep catalogs up-to-date.
Args:
catalog_id (string): Product catalog ID
limit (number): Max results (1–100, default 25)
Returns feed IDs, names, schedules, and latest upload status.
Inputs: catalog_id (required), limit, response_format.
meta_list_productsList ProductsARead-onlyIdempotent
Lists products in a product catalog.
Args:
catalog_id (string): The catalog ID
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
filter (object, optional): Filter criteria (e.g., { availability: "in stock" })
Returns product IDs, names, prices, availability, and more.
Inputs: catalog_id (required), after, limit, filter, +1 more.
meta_list_product_setsList Product SetsARead-onlyIdempotent
Lists product sets (subgroups) in a catalog.
Args:
catalog_id (string): The catalog ID
limit (number): Max results (1–100, default 25)
Returns product set IDs, names, filters, and product counts.
Inputs: catalog_id (required), limit, response_format.
meta_list_saved_audiencesList Saved AudiencesCRead-only
Lists saved audiences (targeting presets) for an ad account.
Args:
ad_account_id (string): Ad account ID
Inputs: ad_account_id (required), after, limit, response_format.
meta_migrate_campaign_to_advantage_plusMigrate Campaign to Advantage+A
Migrates an existing campaign to Advantage+ Shopping (formerly ASC).
Advantage+ Shopping campaigns use Meta's AI to automatically optimize targeting, placements, and creative delivery for online sales. After migration, Meta handles audience selection and budget allocation across placements for better ROAS.
The campaign keeps its original ID — this is an in-place conversion, not a new campaign.
Args:
campaign_id (string): Campaign ID to migrate
ad_account_id (string): Ad account ID (e.g., act_123456789)
Inputs: campaign_id (required), ad_account_id (required), response_format.
meta_publish_instagram_carouselPublish Instagram Carousel PostA
Publishes a carousel post (2–10 images/videos) to Instagram.
Three-step process:
Creates individual media containers for each item
Creates a carousel container referencing them
Publishes the carousel
Args:
ig_account_id (string): Instagram account ID
items (array): Array of up to 10 items, each with:
url (string): Public image URL (JPEG) or video URL
type (string): 'IMAGE' or 'VIDEO'
caption (string, optional): Carousel caption
Returns: Media ID of the published carousel.
Scheduling: Pass scheduled_publish_time (Unix timestamp, 10 min – 75 days in future) to schedule instead of publishing immediately.
Inputs: items (required), ig_account_id (required), caption, response_format, +1 more.
meta_publish_instagram_containerPublish Instagram ContainerA
Publishes a pre-created Instagram media container. Use after checking container status is FINISHED.
Useful for reels/videos where container creation and publishing are done in separate steps.
Args:
ig_account_id (string): Instagram account ID
container_id (string): Container ID (from a previous create step)
Inputs: container_id (required), ig_account_id (required), response_format.
meta_publish_instagram_photoPublish Instagram PhotoA
Publishes a single image post to an Instagram professional account.
Two-step process: creates a media container then publishes it.
Args:
ig_account_id (string): Instagram account ID
image_url (string): Public URL of the JPEG image to post (must be publicly accessible)
caption (string, optional): Post caption (supports hashtags and @mentions)
alt_text (string, optional): Alt text for accessibility (screen readers)
location_id (string, optional): Facebook Place ID to tag location
Returns: Media ID of the published post.
Scheduling: Pass scheduled_publish_time (Unix timestamp, 10 min – 75 days in future) to schedule the post instead of publishing immediately.
Limitations:
JPEG only (no PNG, GIF, HEIC)
Max 100 posts per 24 hours
Image must be hosted on a public server
Inputs: image_url (required), ig_account_id (required), caption, alt_text, +3 more.
meta_publish_instagram_reelPublish Instagram ReelA
Publishes a video reel to an Instagram professional account.
Args:
ig_account_id (string): Instagram account ID
video_url (string): Public URL of the video file (MP4 recommended)
caption (string, optional): Reel caption
share_to_feed (boolean, optional): Also share to feed. Default true.
Returns: Media ID of the published reel.
Notes:
Video must be on a publicly accessible server
Check container status before publishing — video processing can take time
Use meta_check_instagram_container to check readiness
Scheduling: Pass scheduled_publish_time (Unix timestamp, 10 min – 75 days in future) to schedule instead of publishing immediately
Inputs: video_url (required), ig_account_id (required), caption, share_to_feed, +2 more.
meta_publish_instagram_storyPublish Instagram StoryC
Publishes an image or video story to an Instagram professional account.
Args:
ig_account_id (string): Instagram account ID
media_url (string): Public URL of the image or video
media_type (string): 'IMAGE' or 'VIDEO'
Returns: Media ID of the published story.
Inputs: media_url (required), media_type (required), ig_account_id (required), response_format.
meta_publish_page_reelPublish Facebook Page ReelA
Publishes a Reel (short-form video) to a Facebook Page.
Requires: meta_list_pages must be called first to load page tokens.
Args:
page_id (string): Facebook Page ID
video_url (string): Public URL of the video file
description (string, optional): Reel description/caption
title (string, optional): Reel title
Returns: The reel/video ID on success.
Notes:
Video must be hosted on a publicly accessible server
FB Reels use a simpler single-step flow (no container polling needed)
Inputs: page_id (required), video_url (required), title, description, +1 more.
meta_publish_page_storyPublish Facebook Page StoryA
Publishes a story (photo or video) to a Facebook Page.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
media_url (string): Public URL of the image or video
media_type (enum): "photo" or "video"
Returns the story ID on success.
Inputs: page_id (required), media_url (required), media_type (required), response_format.
meta_reply_instagram_commentReply to Instagram CommentA
Replies to a comment on an Instagram media object.
Args:
media_id (string): Instagram media ID (not the comment ID)
message (string): Reply text
comment_id (string, optional): If replying to a specific comment
Returns: Comment ID of the reply.
Inputs: message (required), media_id (required), comment_id, response_format.
meta_reply_post_commentReply to Post CommentA
Replies to a comment on a Facebook Page post.
Args:
comment_id (string): Comment ID to reply to
page_id (string): Page ID (for token lookup)
message (string): Reply text
Inputs: message (required), page_id (required), comment_id (required), response_format.
meta_search_ad_librarySearch Meta Ad LibraryARead-only
Searches the Meta Ad Library for ads from any advertiser. This is a transparency tool — no ad account access needed.
Args:
ad_reached_countries (string[]): Required. ISO country codes where ads were shown (e.g., ["US", "GB"])
search_terms (string, optional): Keywords to search ad text
search_page_ids (string[], optional): Specific Page IDs to search
ad_type (string): ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, EMPLOYMENT_ADS, CREDIT_ADS (default: ALL)
ad_active_status (string): ALL, ACTIVE, INACTIVE (default: ALL)
ad_delivery_date_min (string, optional): Min delivery date YYYY-MM-DD
ad_delivery_date_max (string, optional): Max delivery date YYYY-MM-DD
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
Returns: Ad creatives, spend ranges, impressions, demographics, and targeting info.
Note: Requires a valid access token but does NOT require ad account ownership.
Inputs: ad_reached_countries (required), after, limit, ad_type, +6 more.
meta_search_instagram_catalog_productsSearch Instagram Catalog ProductsARead-onlyIdempotent
Searches for products in an Instagram Shopping catalog by name.
Args:
ig_account_id (string): Instagram account ID
catalog_id (string): Product catalog ID (from meta_get_instagram_available_catalogs)
q (string): Product search query
Returns: Matching products that can be tagged in Instagram posts.
Inputs: q (required), catalog_id (required), ig_account_id (required), response_format.
meta_search_instagram_hashtagSearch Instagram HashtagARead-only
Searches for a hashtag and gets its ID, then retrieves top or recent media.
Two-step process: first looks up the hashtag ID, then fetches media.
Args:
ig_account_id (string): Instagram account ID (required for auth context)
hashtag (string): Hashtag to search (without #)
edge (string): 'top_media' or 'recent_media' (default: top_media)
limit (number): Max results (1–50, default 20)
Note: Limited to 30 unique hashtag searches per 7 days per IG account.
Inputs: hashtag (required), ig_account_id (required), edge, limit, +1 more.
meta_search_placesSearch Facebook PlacesARead-onlyIdempotent
Searches for Facebook Places (locations) by name or coordinates.
Use this to get a location_id for tagging posts, Instagram photos, or Threads.
Args:
q (string, optional): Search query (e.g., "Central Park", "Starbucks NYC")
center (string, optional): Latitude,longitude center point (e.g., "40.7829,-73.9654")
distance (number, optional): Search radius in meters (default: 1000, max: 50000)
limit (number): Max results (1–100, default 20)
categories (string[], optional): Filter by category — e.g., ["FOOD_BEVERAGE", "HOTEL_LODGING", "SHOPPING_RETAIL"]
Returns: Place IDs, names, addresses, and coordinates.
Note: Provide at least q or center. Both can be combined for location-aware name search.
Inputs: q, limit, center, distance, +2 more.
meta_search_targeting_demographicsSearch Targeting DemographicsBRead-onlyIdempotent
Searches for demographic targeting options (job titles, employers, education).
Args:
q (string): Search query
type (string): adworkposition (job titles), adworkemployer (employers), adeducationschool (schools), adeducationmajor (majors)
Inputs: q (required), type (required), limit, response_format.
meta_search_targeting_geolocationsSearch Targeting GeolocationsBRead-onlyIdempotent
Searches for geographic targeting options (countries, regions, cities, zip codes).
Args:
q (string): Location search query (e.g., "New York", "United Kingdom")
type (string): Location type — country, region, city, zip, geo_market, electoral_district
limit (number): Max results (default 25)
Returns: Location keys to use in ad set targeting.
Inputs: q (required), type, limit, response_format.
meta_search_targeting_interestsSearch Targeting InterestsARead-onlyIdempotent
Searches for interest-based targeting options for ad sets.
Args:
q (string): Search query (e.g., "yoga", "cooking")
limit (number): Max results (default 50)
Returns: Interest IDs and names to use in ad set targeting.
Inputs: q (required), limit, response_format.
meta_send_broadcast_channel_messageSend Broadcast Channel MessageA
Sends a message to an Instagram broadcast channel.
Args:
channel_id (string): Broadcast channel ID
message (string): Message text to send
link_url (string, optional): Clickable link to include with the message
Returns: Message ID of the sent message.
Inputs: message (required), channel_id (required), link_url.
meta_send_conversion_eventSend Conversion Event (CAPI)B
Sends a server-side conversion event to Meta via the Conversions API.
Args:
pixel_id: Meta Pixel ID
event_name: Standard events: Purchase, Lead, AddToCart, CompleteRegistration, ViewContent, Search, InitiateCheckout, AddPaymentInfo, AddToWishlist, Subscribe, StartTrial, Contact, CustomizeProduct, Donate, FindLocation, Schedule, SubmitApplication, PageView. Custom event names also accepted.
event_time: Unix timestamp
event_source_url (optional): URL where conversion happened
user_data: At minimum one of: em (hashed email), ph (hashed phone), fbc, fbp, client_ip_address, client_user_agent, external_id
custom_data (optional): { currency, value, content_name, content_ids, content_type, order_id, num_items }
event_id (optional): For deduplication with browser pixel
action_source: "website", "app", "email", "phone_call", "chat", "physical_store", "system_generated", "business_messaging", "other"
test_event_code (optional): For testing without affecting production data
Inputs: pixel_id (required), user_data (required), event_name (required), event_time (required), +6 more.
meta_send_instagram_media_messageSend Instagram Media DMA
Sends an image or link via Instagram Direct Message.
Args:
ig_account_id (string): Instagram account ID (sender)
recipient_id (string): Instagram-scoped user ID of recipient
image_url (string, optional): URL of image to send
link_url (string, optional): URL of link to send (as a generic template)
Provide either image_url or link_url (not both). Same messaging window restrictions as text DMs.
Returns: Message ID.
Inputs: no named parameters.
meta_send_instagram_messageSend Instagram Direct MessageA
Sends a text DM to an Instagram user.
Args:
ig_account_id (string): Instagram account ID (sender)
recipient_id (string): Instagram-scoped user ID of the recipient
message (string): Text message to send
Note: Only works within the 24-hour human agent messaging window or 7-day standard messaging window. The recipient must have messaged the account first.
Returns: Message ID.
Inputs: message (required), recipient_id (required), ig_account_id (required), response_format.
meta_send_offline_eventSend Offline Conversion EventA
Sends an offline conversion event to a Meta offline event set.
Used for tracking in-store purchases, phone orders, or other offline conversions.
Args:
event_set_id (string): Offline event set ID (from meta_list_offline_event_sets)
event_name (string): Event name (e.g., "Purchase", "Lead")
event_time (number): Unix timestamp of the conversion
user_data (object): Customer match data — at least one of: email, phone, fn (first name), ln (last name), ct (city), st (state), zip, country, external_id. All PII must be SHA256 hashed.
custom_data (object, optional): { currency, value, content_name, order_id }
upload_tag (string, optional): Tag for grouping uploads
Returns: Number of events received.
Inputs: user_data (required), event_name (required), event_time (required), event_set_id (required), +3 more.
meta_send_page_messageSend Page MessageA
Sends a message from a Facebook Page to a user (in an existing conversation).
Args:
page_id (string): Facebook Page ID
recipient_id (string): PSID (page-scoped user ID) of the recipient
message (string): Message text
Requires pages_messaging permission. Only works within the 24-hour messaging window.
Inputs: message (required), page_id (required), recipient_id (required).
meta_set_away_messageSet Page Away MessageAIdempotent
Sets the away message for a Facebook Page. This is shown when the page is set to away mode.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
message (string): The away message text
enabled (boolean, default true): Whether away mode is enabled
Inputs: message (required), page_id (required), enabled, response_format.
meta_set_greetingSet Page Messenger GreetingAIdempotent
Sets the Messenger greeting text for a Facebook Page. This is shown to users before they send their first message.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
greeting_text (string): The greeting text (max 160 characters)
Inputs: page_id (required), greeting_text (required), response_format.
meta_set_instant_replySet Page Instant ReplyAIdempotent
Sets the instant reply message for a Facebook Page. This is the automatic message sent immediately when someone messages the page.
Requires: meta_list_pages called first to load page tokens.
Args:
page_id (string): Facebook Page ID
message (string): The instant reply message text
enabled (boolean, default true): Whether instant reply is enabled
Inputs: message (required), page_id (required), enabled, response_format.
meta_subscribe_page_webhooksSubscribe Page to WebhooksAIdempotent
Subscribes your app to receive webhook updates for a Facebook Page.
Args:
page_id (string): Facebook Page ID
subscribed_fields (string[]): Fields to subscribe to, e.g., feed, messages, messaging_postbacks, conversations
Call without subscribed_fields to check current subscriptions.
Inputs: page_id (required), response_format, subscribed_fields.
meta_test_conversion_eventsTest Conversion Event (CAPI)A
Tests CAPI setup by sending a test event that won't affect production data.
Same args as meta_send_conversion_event but auto-sets a test_event_code if not provided. Use the test_event_code from Events Manager > Test Events tab.
Inputs: pixel_id (required), user_data (required), event_name (required), event_time (required), +6 more.
meta_toggle_instagram_commentsToggle Instagram CommentsBIdempotent
Enables or disables comments on an Instagram media object.
Args:
media_id (string): Instagram media ID
enabled (boolean): true to enable comments, false to disable
Inputs: enabled (required), media_id (required).
meta_update_adUpdate AdA
Updates an existing ad's status or name.
Args:
ad_id (string): Ad ID
name (string, optional): New name
status (string, optional): ACTIVE, PAUSED, or ARCHIVED
Inputs: ad_id (required), name, status, response_format.
meta_update_adsetUpdate Ad SetA
Updates an existing ad set. Only provided fields are changed.
Args:
adset_id (string): Ad set ID to update
name (string, optional): New name
status (string, optional): ACTIVE, PAUSED, or ARCHIVED
daily_budget (number, optional): New daily budget in cents
end_time (string, optional): New end time ISO 8601
placement_soft_opt_out (string[], optional): Placements to soft opt-out (up to 5% spend may still go to these). Only for Sales/Leads objectives.
Inputs: adset_id (required), name, status, end_time, +3 more.
meta_update_campaignUpdate CampaignA
Updates an existing campaign. Only provided fields are changed.
Can also migrate a campaign to Advantage+ Shopping by setting migrate_to_advantage_plus to true.
Args:
campaign_id (string): Campaign ID to update
name (string, optional): New campaign name
status (string, optional): ACTIVE, PAUSED, or ARCHIVED
daily_budget (number, optional): New daily budget in cents
lifetime_budget (number, optional): New lifetime budget in cents
migrate_to_advantage_plus (boolean, optional): Migrate this campaign to Advantage+ Shopping (keeps original campaign ID)
Inputs: campaign_id (required), name, status, daily_budget, +3 more.
meta_update_pageUpdate Facebook Page SettingsAIdempotent
Updates a Facebook Page's profile information.
Args:
page_id (string): Facebook Page ID
about (string, optional): Short description (max 255 chars)
description (string, optional): Long description
website (string, optional): Website URL
phone (string, optional): Phone number
emails (string[], optional): Contact emails
hours (object, optional): Business hours as key-value pairs (e.g., {"mon_1_open":"09:00","mon_1_close":"17:00"})
category (string, optional): Page category (e.g., "Restaurant")
username (string, optional): Page username/vanity URL
contact_address (object, optional): Mailing address with street, city, state, zip, country
Requires pages_manage_metadata permission.
Inputs: page_id (required), about, hours, phone, +6 more.
meta_update_page_coverUpdate Facebook Page Cover PhotoAIdempotent
Updates a Facebook Page's cover photo.
Args:
page_id (string): Facebook Page ID
cover_url (string, optional): URL of the new cover photo
photo_id (string, optional): ID of an existing photo to use as cover
offset_y (number, optional): Vertical offset of the cover photo (0–100)
no_feed_story (boolean, optional): If true, don't publish a feed story about the change
Provide either cover_url or photo_id. Requires pages_manage_metadata permission.
Inputs: page_id (required), offset_y, photo_id, cover_url, +2 more.
meta_update_page_pictureUpdate Facebook Page Profile PictureAIdempotent
Updates a Facebook Page's profile picture.
Args:
page_id (string): Facebook Page ID
picture_url (string): URL of the new profile picture
Requires pages_manage_metadata permission.
Inputs: page_id (required), picture_url (required), response_format.
meta_update_pixelUpdate Meta PixelCIdempotent
Updates pixel settings.
Args:
pixel_id (string): Pixel ID
name (string, optional): New pixel name
first_party_cookie_status (string, optional): "EMPTY", "FIRST_PARTY_COOKIE_ENABLED", or "FIRST_PARTY_COOKIE_DISABLED"
automatic_matching_fields (string[], optional): e.g. ["em","ph","fn","ln","ct","st","zp","country","db","ge","external_id"]
data_use_setting (string, optional): "EMPTY" or "DATA_USE_SETTING_LDU"
Inputs: pixel_id (required), name, response_format, data_use_setting, +2 more.
meta_update_postUpdate Facebook PostBIdempotent
Updates an existing Facebook Page post's message text.
Args:
post_id (string): Post ID
page_id (string): Page ID (for token)
message (string): New message text
Inputs: message (required), page_id (required), post_id (required), response_format.
meta_update_productUpdate ProductBIdempotent
Updates a product's details.
Args:
product_id (string): The product ID
name, description, price, availability, image_url, url (all optional)
Returns confirmation of the update.
Inputs: product_id (required), url, name, price, +4 more.
meta_upload_ad_imageUpload Ad ImageA
Uploads an image to an ad account's image library for use in creatives.
Args:
ad_account_id (string): Ad account ID
url (string): Public URL of the image to upload
name (string, optional): Name for the uploaded image
Returns: Image hash (used when creating ad creatives).
Inputs: url (required), ad_account_id (required), name, response_format.
meta_upload_ad_videoUpload Ad VideoB
Uploads a video to an ad account's video library for use in creatives.
Args:
ad_account_id (string): Ad account ID
file_url (string): Public URL of video file
title (string, optional): Video title
description (string, optional): Video description
Inputs: file_url (required), ad_account_id (required), title, description, +1 more.
threads_check_rate_limitsCheck Threads Publishing LimitsBRead-only
Checks the current publishing rate limit usage for Threads.
Args:
threads_user_id (string): Threads user ID
Returns: Current usage and limit quota (250 posts per 24 hours).
Inputs: threads_user_id (required), response_format.
threads_delete_postDelete ThreadBDestructive
Deletes a Threads post permanently.
Args:
media_id (string): Threads media ID to delete
Inputs: media_id (required).
threads_get_conversationGet Threads ConversationBRead-only
Gets the full conversation tree (all replies at all levels) for a Threads post.
Args:
media_id (string): Root thread media ID
reverse (boolean, optional): Reverse chronological order
Inputs: media_id (required), reverse, response_format.
threads_get_followersGet Threads FollowersBRead-only
Lists followers of the authenticated Threads user.
Args:
threads_user_id (string): Threads user ID
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
Returns: User IDs, usernames, and profile picture URLs of followers.
Note: Requires threads_basic scope. Only returns users who have allowed their followers list to be visible.
Inputs: threads_user_id (required), after, limit, response_format.
threads_get_followingGet Threads FollowingARead-only
Lists accounts that the authenticated Threads user is following.
Args:
threads_user_id (string): Threads user ID
limit (number): Max results (1–100, default 25)
after (string, optional): Pagination cursor
Returns: User IDs, usernames, and profile pictures of followed accounts.
Inputs: threads_user_id (required), after, limit, response_format.
threads_get_media_childrenGet Threads Carousel ItemsARead-onlyIdempotent
Gets individual items in a Threads carousel post.
Args:
media_id (string): Carousel media ID
Inputs: media_id (required), response_format.
threads_get_mentionsGet Threads MentionsBRead-only
Gets posts where the authenticated user was @mentioned.
Args:
threads_user_id (string): Threads user ID
Inputs: threads_user_id (required), response_format.
threads_get_postGet Single Thread PostCRead-onlyIdempotent
Gets details for a single Threads post by ID.
Args:
media_id (string): Threads media ID
Inputs: media_id (required), response_format.
threads_get_post_insightsGet Thread Post InsightsARead-onlyIdempotent
Gets performance metrics for a specific Threads post.
Args:
media_id (string): Threads media ID
metrics (string[]): Metrics to retrieve. Options: views, likes, replies, reposts, quotes, shares, reach, saved
Returns: Metric values for the post.
Inputs: media_id (required), metrics, response_format.
threads_get_postsGet Threads PostsARead-only
Lists the authenticated user's Threads posts.
Args:
threads_user_id (string): Threads user ID (from threads_get_profile)
limit (number): Max results (1–100, default 20)
since (string, optional): Start date YYYY-MM-DD
until (string, optional): End date YYYY-MM-DD
after (string, optional): Pagination cursor
Inputs: threads_user_id (required), after, limit, since, +2 more.
threads_get_profileGet Threads ProfileARead-onlyIdempotent
Gets the authenticated user's Threads profile.
Returns: User ID, username, name, bio, and profile picture URL.
Requires: THREADS_ACCESS_TOKEN env var.
Inputs: response_format.
threads_get_repliesGet Thread RepliesBRead-only
Gets replies to a Threads post.
Args:
media_id (string): Threads media ID
reverse (boolean, optional): Reverse chronological order (default false)
Inputs: media_id (required), reverse, response_format.
threads_get_user_insightsGet Threads User InsightsARead-only
Gets account-level metrics for the authenticated Threads user.
Args:
threads_user_id (string): Threads user ID
metrics (string[]): Options: Time-series: views, likes, replies, reposts, quotes, followers_count, reach Demographics: follower_demographics (breakdown by age, country, city, gender — requires 100+ followers)
since (string, optional): Start date YYYY-MM-DD (required for time-series metrics)
until (string, optional): End date YYYY-MM-DD
breakdown (string, optional): For follower_demographics: 'age', 'country', 'city', 'gender'
Inputs: threads_user_id (required), since, until, metrics, +2 more.
threads_hide_replyHide/Unhide Thread ReplyAIdempotent
Hides or unhides a reply on a Threads post.
Args:
reply_id (string): Reply media ID
hide (boolean): true to hide, false to unhide
Inputs: hide (required), reply_id (required).
threads_publish_carouselPublish Carousel ThreadA
Publishes a carousel post (2–20 images/videos) to Threads.
Three-step flow:
Create individual item containers
Create carousel container referencing them
Publish
Args:
threads_user_id (string): Threads user ID
items (array): 2–20 items, each with url (string) and type ('IMAGE' or 'VIDEO')
text (string, optional): Caption text
Inputs: items (required), threads_user_id (required), text, reply_control, +1 more.
threads_publish_gifPublish GIF ThreadA
Publishes a GIF post to Threads using a GIPHY URL.
Two-step flow: creates a container, then publishes it.
Args:
threads_user_id (string): Threads user ID
gif_url (string): GIPHY URL of the GIF
text (string, optional): Caption text
reply_to_id (string, optional): Thread ID to reply to
reply_control (enum, optional): Who can reply — everyone, accounts_you_follow, or mentioned_only
Returns: Media ID of the published thread.
Inputs: gif_url (required), threads_user_id (required), text, reply_to_id, +2 more.
threads_publish_imagePublish Image ThreadC
Publishes an image post to Threads.
Args:
threads_user_id (string): Threads user ID
image_url (string): Public URL of the image (JPEG or PNG)
text (string, optional): Caption text
Inputs: image_url (required), threads_user_id (required), text, location_id, +2 more.
threads_publish_linkPublish Link ThreadC
Publishes a thread post with a link attachment.
Args:
threads_user_id (string): Threads user ID
text (string): Post text containing the URL
link_attachment (string): URL to attach as a link preview
Inputs: text (required), link_attachment (required), threads_user_id (required), reply_control, +1 more.
threads_publish_textPublish Text ThreadA
Publishes a text-only post to Threads.
Two-step flow: creates a container, then publishes it.
Args:
threads_user_id (string): Threads user ID
text (string): Post text (up to 500 characters)
reply_to_id (string, optional): Thread ID to reply to
quote_post_id (string, optional): Thread ID to quote
Returns: Media ID of the published thread.
Inputs: text (required), threads_user_id (required), location_id, reply_to_id, +3 more.
threads_publish_videoPublish Video ThreadA
Publishes a video post to Threads.
Args:
threads_user_id (string): Threads user ID
video_url (string): Public URL of the video (MP4)
text (string, optional): Caption text
Note: Video processing may take time. Polls for up to 60 seconds.
Inputs: video_url (required), threads_user_id (required), text, location_id, +2 more.
threads_repostRepost a ThreadA
Reposts (shares) an existing thread to your profile.
Args:
threads_user_id (string): Your Threads user ID
media_id (string): Thread media ID to repost
Inputs: media_id (required), threads_user_id (required), response_format.
threads_searchSearch Threads by KeywordARead-only
Searches Threads posts by keyword.
Args:
threads_user_id (string): Threads user ID (for auth context)
q (string): Search query
limit (number): Max results (default 20)
Note: Results are limited to the authenticated user's content and public threads.
Inputs: q (required), threads_user_id (required), limit, response_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 200 tools
Tools are organized by platform and resource, and even the many list/get variants have descriptions that clarify their scope. A handful of similarly named retrievers—like meta_get_posts vs. meta_get_published_posts and meta_get_instagram_media vs. meta_get_instagram_single_media—require careful reading, but no tools are true duplicates.
The dominant meta_verb_noun and threads_verb_noun pattern is clear and predictable across nearly all tools. Minor inconsistencies such as meta_get_instagram_media being a list operation rather than a single-item getter, and mixing create/publish verbs for content creation, prevent a perfect score.
200 tools is an extreme count that far exceeds any reasonable MCP server scope. Even for a broad Meta API wrapper, the sheer number creates significant selection overhead and makes it difficult for an agent to reliably choose the right tool.
The surface covers Facebook Pages, posts, messaging, Instagram publishing, comments, DMs, ads, audiences, pixels, Threads, and product catalogs in impressive depth. Minor lifecycle gaps remain—such as no update for ad rules or saved audiences, no catalog creation, and no Instagram media editing—but agents can generally work around them.
Maintenance
Related MCP Connectors
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Instagram MCP for DM and comment automation, AI Agent and content publishing via Meta's official API
Instagram and Facebook Pages for AI agents: publish, comments, DM by keyword, inbox, insights.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Facebook and Instagram advertising via the Meta Marketing API. It provides comprehensive tools for campaign lifecycle management, performance analytics, audience targeting, and creative optimization.39 npm202MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Facebook and Instagram advertising data through the Meta Marketing API. It supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.808 npmMIT
- AlicenseBqualityFmaintenanceConnects AI assistants to Meta's business platforms (Facebook, Instagram, Threads, Ads, Commerce) with 200 tools for publishing, engagement, analytics, ads, and commerce management.100520 npm68MIT
- AlicenseNot gradedqualityBmaintenanceSelf-hosted MCP server providing secure, multi-tenant access to Meta Marketing API for managing Facebook and Instagram Ads via AI agents, with OAuth, encrypted tokens, and compliance features.27MIT