zernio-mcp

A Model Context Protocol (MCP) server that gives Claude full access to the Zernio social media management API — 273 tools covering posts, analytics, inbox, ads, contacts, WhatsApp Business, and more across 14+ platforms.

Quick Start

Option 1: npx (recommended)

No installation needed. Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "zernio": {
      "command": "npx",
      "args": ["zernio-mcp"],
      "env": {
        "ZERNIO_API_KEY": "your_zernio_api_key_here"
      }
    }
  }
}

Also available as @eyalm321/zernio-mcp on GitHub Packages.

Option 2: Local install

git clone https://github.com/Eyalm321/zernio-mcp.git
cd zernio-mcp
npm install
npm run build

Then configure Claude Desktop:

{
  "mcpServers": {
    "zernio": {
      "command": "node",
      "args": ["/absolute/path/to/zernio-mcp/dist/index.js"],
      "env": {
        "ZERNIO_API_KEY": "your_zernio_api_key_here"
      }
    }
  }
}

Getting your API key

1. Log in to zernio.com
2. Go to Settings > API Keys
3. Create a new key and copy it

---

Tools (273 total)

Accounts (42 tools)

Tool	Description
zernio_list_accounts	List all connected social media accounts
zernio_get_follower_stats	Get follower count and stats for an account
zernio_get_account_health	Check connection health for all accounts
zernio_get_single_account_health	Check connection health for a specific account
zernio_update_account	Update account display name or username
zernio_disconnect_account	Disconnect a social media account
zernio_get_linkedin_mentions	Get LinkedIn mentions and tags
zernio_get_linkedin_organizations	List LinkedIn organization pages
zernio_switch_linkedin_organization	Switch LinkedIn account type
zernio_get_facebook_page	Get Facebook Page details
zernio_update_facebook_page	Update Facebook Page settings
zernio_get_pinterest_boards	List Pinterest boards
zernio_set_default_pinterest_board	Set default Pinterest board
zernio_get_youtube_playlists	List YouTube playlists
zernio_set_default_youtube_playlist	Set default YouTube playlist
zernio_get_reddit_flairs	List subreddit flairs
zernio_get_reddit_subreddits	List user's subreddits
zernio_set_default_reddit_subreddit	Set default subreddit
zernio_get_tiktok_creator_info	Get TikTok creator info and limits
zernio_get_messenger_menu	Get Facebook Messenger persistent menu
zernio_set_messenger_menu	Set Messenger persistent menu
zernio_delete_messenger_menu	Remove Messenger persistent menu
zernio_get_telegram_commands	Get Telegram bot commands
zernio_set_telegram_commands	Set Telegram bot commands
zernio_delete_telegram_commands	Remove Telegram bot commands
zernio_get_instagram_ice_breakers	Get Instagram DM ice breaker questions
zernio_set_instagram_ice_breakers	Set Instagram DM ice breakers
zernio_delete_instagram_ice_breakers	Remove Instagram DM ice breakers
zernio_get_gmb_locations	List Google Business Profile locations
zernio_get_gmb_reviews	Get Google Business reviews
zernio_get_gmb_location_details	Get GMB location details (hours, address, etc.)
zernio_update_gmb_location_details	Update GMB location details
zernio_get_gmb_food_menus	Get GMB restaurant food menus
zernio_update_gmb_food_menus	Update GMB food menus
zernio_get_gmb_media	List GMB location photos/videos
zernio_upload_gmb_media	Upload photo to GMB location
zernio_delete_gmb_media	Delete GMB media
zernio_get_gmb_attributes	Get GMB business attributes
zernio_update_gmb_attributes	Update GMB business attributes
zernio_get_gmb_place_actions	Get GMB action links
zernio_create_gmb_place_action	Create GMB action link
zernio_delete_gmb_place_action	Delete GMB action link

Posts & Media (25 tools)

Tool	Description
zernio_list_posts	List scheduled/published posts
zernio_get_post	Get post details and performance
zernio_create_post	Create a new post (draft or scheduled)
zernio_update_post	Update a draft or scheduled post
zernio_delete_post	Delete a post
zernio_publish_post_now	Publish a draft immediately
zernio_duplicate_post	Duplicate a post as a new draft
zernio_retry_post	Retry a failed post
zernio_edit_published_post	Edit an already-published post
zernio_unpublish_post	Remove a published post
zernio_update_post_metadata	Update post tags and labels
zernio_bulk_upload_posts	Bulk create posts from a list
zernio_list_post_queue	Get the scheduled post queue
zernio_list_post_labels	List all post labels/tags
zernio_get_post_approval_status	Get post approval status
zernio_approve_post	Approve a pending post
zernio_reject_post	Reject a pending post
zernio_validate_post_content	Validate content against platform rules
zernio_get_post_logs	Get activity logs for a post
zernio_get_publishing_logs	Get publishing logs across all posts
zernio_upload_media	Upload media by URL
zernio_upload_media_direct	Upload media file directly
zernio_get_media_presigned_url	Get presigned URL for large uploads
zernio_list_media	List uploaded media files
zernio_delete_media	Delete a media file

Analytics (16 tools)

Tool	Description
zernio_get_post_analytics	Post metrics: impressions, reach, likes, shares, clicks
zernio_get_follower_analytics	Follower growth over time
zernio_get_best_times_to_post	Optimal posting times based on engagement
zernio_get_daily_metrics	Day-by-day impressions, reach, engagement
zernio_get_content_decay	Post performance decay over time
zernio_get_post_timeline	Post performance timeline (hour by hour)
zernio_get_posting_frequency	Posting frequency vs engagement correlation
zernio_get_instagram_insights	Instagram account-level insights
zernio_get_instagram_demographics	Instagram audience demographics
zernio_get_youtube_analytics	YouTube daily views and watch time
zernio_get_youtube_demographics	YouTube audience demographics
zernio_get_linkedin_analytics	LinkedIn account-level analytics
zernio_get_linkedin_post_analytics	LinkedIn per-post analytics
zernio_get_linkedin_post_reactions	LinkedIn reactions breakdown
zernio_get_google_business_performance	GMB views, calls, direction requests
zernio_get_google_business_keywords	GMB search keywords

Ads (19 tools)

Tool	Description
zernio_list_ad_accounts	List connected ad accounts
zernio_get_ads_tree	Get full campaign/ad-set/ad hierarchy
zernio_list_campaigns	List ad campaigns
zernio_create_campaign	Create a new campaign
zernio_update_campaign_status	Pause or resume a campaign
zernio_list_ads	List ads across campaigns
zernio_get_ad	Get ad details
zernio_get_ad_analytics	Get ad performance metrics
zernio_create_ad	Create a standalone ad with custom creative
zernio_update_ad	Update ad (pause, budget, name)
zernio_delete_ad	Cancel an ad
zernio_boost_post	Boost an existing post as a paid ad
zernio_sync_ads	Sync ads from platform ad managers
zernio_list_audiences	List custom audiences
zernio_create_audience	Create a custom audience
zernio_get_audience	Get audience details
zernio_delete_audience	Delete a custom audience
zernio_add_audience_users	Add users to an audience
zernio_get_ad_interests	Browse targeting interests

Messages / DMs (10 tools)

Tool	Description
zernio_list_conversations	List DM conversations across platforms
zernio_get_conversation	Get conversation details
zernio_list_messages	Read messages in a conversation
zernio_send_message	Send a DM reply
zernio_create_conversation	Start a new DM conversation
zernio_edit_message	Edit a sent message
zernio_delete_message	Delete a message
zernio_send_typing_indicator	Show typing indicator
zernio_react_to_message	Add/remove emoji reactions
zernio_update_conversation_status	Mark as read/unread/archived

Comments (8 tools)

Tool	Description
zernio_list_commented_posts	List posts with comments
zernio_get_post_comments	Get all comments on a post
zernio_reply_to_comment	Reply publicly to a comment
zernio_private_reply_to_comment	Send a private reply to a commenter
zernio_like_comment	Like a comment
zernio_hide_comment	Hide a comment from public view
zernio_unhide_comment	Unhide a hidden comment
zernio_delete_comment	Delete a comment

Reviews (3 tools)

Tool	Description
zernio_list_reviews	List reviews across platforms
zernio_reply_to_review	Reply to a review
zernio_delete_review_reply	Delete a review reply

Contacts & CRM (11 tools)

Tool	Description
zernio_list_contacts	List all contacts
zernio_get_contact	Get contact details
zernio_create_contact	Create a contact
zernio_update_contact	Update contact details
zernio_delete_contact	Delete a contact
zernio_bulk_create_contacts	Bulk create contacts
zernio_get_contact_channels	Get contact's social channels
zernio_update_contact_field	Update a custom field value
zernio_list_custom_fields	List custom field definitions
zernio_create_custom_field	Create a custom field
zernio_delete_custom_field	Delete a custom field

Broadcasts (7 tools)

Tool	Description
zernio_list_broadcasts	List all broadcasts
zernio_get_broadcast	Get broadcast details
zernio_create_broadcast	Create a broadcast message
zernio_schedule_broadcast	Schedule a broadcast
zernio_send_broadcast	Send a broadcast immediately
zernio_cancel_broadcast	Cancel a scheduled broadcast
zernio_get_broadcast_recipients	Get broadcast recipient list

Automations (6 tools)

Tool	Description
zernio_list_automations	List comment-to-DM automations
zernio_get_automation	Get automation details
zernio_create_automation	Create a comment automation rule
zernio_update_automation	Update an automation
zernio_delete_automation	Delete an automation
zernio_get_automation_logs	Get automation execution logs

Sequences / Drip Campaigns (8 tools)

Tool	Description
zernio_list_sequences	List message sequences
zernio_get_sequence	Get sequence details and steps
zernio_create_sequence	Create a drip campaign sequence
zernio_update_sequence	Update sequence name or steps
zernio_delete_sequence	Delete a sequence
zernio_activate_sequence	Activate a paused sequence
zernio_pause_sequence	Pause an active sequence
zernio_list_sequence_enrollments	List enrolled contacts

Contact Enrollment (2 tools)

Tool	Description
zernio_enroll_contact_in_sequence	Enroll a contact in a sequence
zernio_unenroll_contact_from_sequence	Remove a contact from a sequence

Tags (3 tools)

Tool	Description
zernio_list_contact_tags	List all contact tags
zernio_add_contact_tag	Add a tag to a contact
zernio_remove_contact_tag	Remove a tag from a contact

Twitter/X Actions (8 tools)

Tool	Description
zernio_twitter_retweet	Retweet a tweet
zernio_twitter_unretweet	Undo a retweet
zernio_twitter_like	Like a tweet
zernio_twitter_unlike	Unlike a tweet
zernio_twitter_bookmark	Bookmark a tweet
zernio_twitter_remove_bookmark	Remove a bookmark
zernio_twitter_follow	Follow a user
zernio_twitter_unfollow	Unfollow a user

Reddit (4 tools)

Tool	Description
zernio_reddit_upvote	Upvote a post or comment
zernio_reddit_submit_post	Submit a post to a subreddit
zernio_search_reddit	Search Reddit posts
zernio_get_reddit_feed	Get subreddit feed

Queue Scheduling (6 tools)

Tool	Description
zernio_list_queue_slots	List scheduled time slots
zernio_create_queue_slot	Create a queue slot
zernio_update_queue_slot	Update a queue slot
zernio_delete_queue_slot	Delete a queue slot
zernio_preview_queue	Preview upcoming scheduled slots
zernio_get_next_queue_slot	Get next available slot

Validation (4 tools)

Tool	Description
zernio_validate_post_length	Check post character count limits
zernio_validate_post	Validate post content against platform rules
zernio_validate_media	Validate media files for a platform
zernio_validate_subreddit	Check if a subreddit exists

Connect / OAuth (17 tools)

Tool	Description
zernio_get_connect_url	Get OAuth authorization URL for any platform
zernio_get_pending_connection_data	Get pending OAuth connection data
zernio_connect_bluesky	Connect Bluesky via credentials
zernio_connect_telegram_start	Start Telegram bot connection
zernio_connect_telegram_verify	Verify Telegram connection code
zernio_check_telegram_connection	Check Telegram connection status
zernio_connect_whatsapp	Connect WhatsApp Business
zernio_list_facebook_pages_for_connect	List Facebook pages during OAuth
zernio_select_facebook_page	Select a Facebook page to connect
zernio_list_snapchat_profiles_for_connect	List Snapchat profiles during OAuth
zernio_select_snapchat_profile	Select a Snapchat profile
zernio_list_google_business_locations_for_connect	List GMB locations during OAuth
zernio_select_google_business_location	Select a GMB location
zernio_list_linkedin_organizations_for_connect	List LinkedIn orgs during OAuth
zernio_select_linkedin_organization	Select a LinkedIn organization
zernio_list_pinterest_boards_for_connect	List Pinterest boards during OAuth
zernio_select_pinterest_board	Select a Pinterest board

Webhooks (5 tools)

Tool	Description
zernio_list_webhooks	List configured webhooks
zernio_create_webhook	Create a webhook
zernio_delete_webhook	Delete a webhook
zernio_update_webhook	Update webhook settings
zernio_test_webhook	Send a test webhook event
zernio_get_webhook_logs	Get webhook delivery logs

WhatsApp Business (44 tools)

Tool	Description
zernio_get_whatsapp_business_profile	Get WhatsApp Business profile
zernio_update_whatsapp_business_profile	Update business profile
zernio_get_whatsapp_display_name	Get display name and review status
zernio_set_whatsapp_display_name	Request display name change
zernio_set_whatsapp_profile_photo	Upload profile picture
zernio_list_whatsapp_templates	List message templates
zernio_create_whatsapp_template	Create a message template
zernio_get_whatsapp_template	Get template by name
zernio_update_whatsapp_template	Update a template
zernio_delete_whatsapp_template	Delete a template
zernio_list_whatsapp_phone_numbers	List registered phone numbers
zernio_get_whatsapp_phone_number	Get phone number details
zernio_purchase_whatsapp_phone_number	Purchase a phone number
zernio_release_whatsapp_phone_number	Release a phone number
zernio_request_whatsapp_verification_code	Request verification code
zernio_verify_whatsapp_phone_number	Verify a phone number
zernio_list_whatsapp_flows	List interactive flows
zernio_create_whatsapp_flow	Create a flow
zernio_get_whatsapp_flow	Get flow details
zernio_update_whatsapp_flow	Update a flow
zernio_delete_whatsapp_flow	Delete a flow
zernio_publish_whatsapp_flow	Publish a flow
zernio_deprecate_whatsapp_flow	Deprecate a flow
zernio_upload_whatsapp_flow_json	Upload flow JSON definition
zernio_get_whatsapp_flow_json	Get flow JSON definition
zernio_send_whatsapp_flow_message	Send a flow to a contact
zernio_trigger_whatsapp_flow	Trigger a flow for a contact
zernio_list_whatsapp_groups	List WhatsApp groups
zernio_create_whatsapp_group	Create a group
zernio_get_whatsapp_group	Get group details
zernio_update_whatsapp_group	Update group settings
zernio_delete_whatsapp_group	Delete a group
zernio_add_whatsapp_group_participants	Add group members
zernio_remove_whatsapp_group_participants	Remove group members
zernio_create_whatsapp_group_invite_link	Generate invite link
zernio_list_whatsapp_group_join_requests	List join requests
zernio_approve_whatsapp_group_join_requests	Approve join requests
zernio_reject_whatsapp_group_join_requests	Reject join requests
zernio_send_whatsapp_bulk	Bulk send template messages
zernio_list_whatsapp_contacts	List WhatsApp contacts
zernio_create_whatsapp_contact	Create a contact
zernio_get_whatsapp_contact	Get contact details
zernio_update_whatsapp_contact	Update a contact
zernio_delete_whatsapp_contact	Delete a contact
zernio_import_whatsapp_contacts	Bulk import contacts
zernio_bulk_update_whatsapp_contacts	Bulk update contacts
zernio_list_whatsapp_contact_groups	List contact groups

Profiles & Workspace (20 tools)

Tool	Description
zernio_get_profile	Get current user profile
zernio_update_profile	Update user profile
zernio_list_profiles	List Zernio profiles (brands/projects)
zernio_create_zernio_profile	Create a new profile
zernio_get_zernio_profile	Get profile details
zernio_update_zernio_profile	Update a profile
zernio_delete_zernio_profile	Delete a profile
zernio_list_account_groups	List account groups
zernio_create_account_group	Create an account group
zernio_update_account_group	Update an account group
zernio_delete_account_group	Delete an account group
zernio_list_users	List workspace team members
zernio_get_user	Get user details
zernio_invite_user	Invite a team member
zernio_remove_user	Remove a team member
zernio_create_invite_token	Create an invite token
zernio_get_usage_stats	Get workspace usage statistics
zernio_list_api_keys	List API keys
zernio_create_api_key	Create an API key
zernio_delete_api_key	Revoke an API key

Logs (2 tools)

Tool	Description
zernio_get_webhook_logs	Get webhook delivery logs
zernio_get_connection_logs	Get connection attempt logs

---

Supported Platforms

Platform	Posts	Analytics	Inbox	Reviews	Ads
Twitter/X	Yes	Yes	Yes	-	-
Instagram	Yes	Yes	Yes	-	Yes
Facebook	Yes	Yes	Yes	-	Yes
LinkedIn	Yes	Yes	Yes	-	-
TikTok	Yes	-	-	-	-
YouTube	Yes	Yes	Yes	-	-
Pinterest	Yes	-	-	-	Yes
Reddit	Yes	-	-	-	-
Bluesky	Yes	-	-	-	-
Threads	Yes	-	-	-	-
Google Business	Yes	Yes	-	Yes	Yes
Telegram	-	-	Yes	-	-
Snapchat	Yes	-	-	-	-
WhatsApp	-	-	Yes	-	-

---

Example Prompts

Once configured, you can ask Claude things like:

• "What comments came in today across all my social accounts?"
• "Reply to all unanswered DMs with a friendly acknowledgment"
• "Show me the engagement stats for my last 5 Instagram posts"
• "What's the best time to post on Instagram based on my audience?"
• "Summarize all new reviews and draft replies for the 1-star ones"
• "Create a post saying 'Hello World!' scheduled for tomorrow at 9am on Twitter and LinkedIn"
• "Boost my best-performing post from this week with a $50 budget"
• "Show me my follower growth over the past 30 days"
• "Send a WhatsApp template message to all my VIP contacts"
• "Set up an automation to auto-reply when someone comments 'price' on my posts"
• "What's my Google Business Profile performance this month?"
• "Create a drip campaign sequence with 3 follow-up messages"

---

Development

npm install
npm run build       # compile TypeScript
npm start           # run the server
npm test            # run all tests (667 tests)
npm run test:watch  # run tests in watch mode

Project Structure

src/
  index.ts                  # MCP server entry point
  client.ts                 # API request utility
  tools/
    accounts.ts             # 42 tools - account management, GMB, platform settings
    ads.ts                  # 19 tools - campaigns, ads, audiences, targeting
    analytics.ts            # 16 tools - metrics, demographics, insights
    automations.ts          #  6 tools - comment-to-DM automations
    broadcasts.ts           #  7 tools - mass messaging
    comments.ts             #  8 tools - comment management
    connect.ts              # 17 tools - OAuth and platform connections
    contacts.ts             # 11 tools - CRM contacts and custom fields
    messages.ts             # 10 tools - DM conversations
    posts.ts                # 25 tools - post CRUD, media, approval workflows
    profiles.ts             # 20 tools - workspace, users, API keys
    queue.ts                #  6 tools - scheduling queue slots
    reddit.ts               #  2 tools - Reddit search and feed
    reviews.ts              #  3 tools - review management
    social.ts               # 33 tools - Twitter, sequences, webhooks, tags
    validation.ts           #  4 tools - content and media validation
    whatsapp-business.ts    # 44 tools - WhatsApp Business full suite
  __tests__/                # 667 tests across 19 test files

Built With

• @modelcontextprotocol/sdk - MCP server framework
• Zod - Schema validation
• Vitest - Testing framework
• TypeScript / Node.js

---

CI/CD

• CI: Runs on every push and PR to main — builds and tests on Node 20 and 22
• Publish: Automatically publishes to both npm and GitHub Packages when a GitHub release is created (requires NPM_TOKEN secret for npm; GitHub Packages uses GITHUB_TOKEN automatically)

---

License

MIT