meta-ai-mcp

Model Context Protocol (MCP) server that wraps the meta-ai REST API, giving Claude Desktop (or any MCP client) direct access to WhatsApp, Messenger, and Instagram messaging, social analytics, and ads analytics.

Environment variables

| Variable | Required | Default | Description | | ----------------- | -------- | ----------------------------------- | -------------------------------------------- | | META_AI_API_KEY | Yes | — | API key starting with mta_... | | META_AI_API_URL | No | https://api-meta.agenticlabs.site | Override the base URL (useful for local dev) |

Installation in Claude Desktop

1. Build the server

cd mcp-server
npm install
npm run build

2. Add to Claude Desktop config

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:

{
  "mcpServers": {
    "meta-ai": {
      "command": "node",
      "args": ["/absolute/path/to/meta-ai/mcp-server/dist/index.js"],
      "env": {
        "META_AI_API_KEY": "mta_your_key_here"
      }
    }
  }
}

Replace /absolute/path/to/meta-ai with the actual path on your machine.

Alternatively, if you installed the package globally (npm install -g):

{
  "mcpServers": {
    "meta-ai": {
      "command": "meta-ai-mcp",
      "env": {
        "META_AI_API_KEY": "mta_your_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the config, fully quit and reopen Claude Desktop. The tools will appear in the tool picker.

Available tools

| Tool | Description | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | send_message | Send a message via any connected Meta channel. Supports: text, template, image, document, button_template, generic_template, sender_action, reaction, interactive_buttons, interactive_list | | list_inbox_contacts | List inbox contacts grouped by user across all channels | | get_conversation_history | Retrieve message history for a specific user on a channel | | get_social_summary | Cross-platform social analytics summary (reach, engagement, followers) | | list_instagram_posts | Recent Instagram posts with engagement metrics | | list_facebook_posts | Recent Facebook Page posts with engagement metrics | | list_ad_accounts | List all connected Meta ad accounts | | get_ad_account_summary | Spend, impressions, clicks, CTR, and CPC for an ad account | | list_whatsapp_templates | List WhatsApp message templates, filterable by status | | list_messenger_templates | List Messenger utility templates, filterable by status |

Development

# Type-check without building
npm run typecheck

# Run directly with tsx (no build step)
META_AI_API_KEY=mta_... npm run dev

# Build for production
npm run build

# Run the built output
META_AI_API_KEY=mta_... npm start