MCP server for your
AI inbox.
Claude Code, Cursor, Windsurf, Zed, and Claude Desktop get direct access to your Instagram DMs, WhatsApp chats, and Messenger inbox - reading conversations, drafting replies, managing the template lifecycle, and debugging journey deliveries through up to 114 tools, 13 prompts, an interactive workspace, and two resource templates. Run one npx command and ask your agent to connect: it pairs itself through a signed setup link, the same device authorization grant gh auth login uses, so no dashboard visit and no copied API key are needed first.
mcp config · pick one
{
"mcpServers": {
"instantreply": {
"command": "npx",
"args": [
"-y",
"@instantreply.co/mcp"
]
}
}
}Prefer no install? Claude.ai: Settings → Connectors → Add custom connector → paste https://api.instantreply.co/mcp → sign in. ChatGPT: add it as a connector with developer mode on. The 7-day free trial on yearly plans requires a card; nothing is charged until day 8. Monthly plans have no trial. No key yet? Add the zero-key block, restart the client, and ask it to connect InstantReply. It hands you a code and a link. Already paired? Use the slash commands like /audit_template_cost or /utility_rewrite_loop.
Install · zero-key
Any agent that can run npx can do this.
No dashboard visit, no copied key. The server requests a device code the way gh auth login or a smart-TV app does (RFC 8628, device authorization grant), shows you a link, and picks up the key the moment you approve it in a browser.
- 01
Add the block
Drop this in your client's MCP config. No key, no global install.
json "instantreply": { "command": "npx", "args": ["-y", "@instantreply.co/mcp"] } - 02
Ask it to connect
Your agent calls start_setup and gets back a code and a link. Open the link, sign up or log in (captcha and consent apply, same as the site), and approve.
json { "instructions": "Tell the user to open this link and approve: https://www.instantreply.co/pair/ABCD-2345", "code": "ABCD-2345", "link": "https://www.instantreply.co/pair/ABCD-2345", "expires_in_seconds": 600, "device_code": "kx9F2q... (opaque, single use)", "poll_interval_seconds": 5, "next_step": "Call check_setup with this device_code once approved." } - 03
Reconnect, then ask
check_setup confirms the approval and caches the key at ~/.instantreply/config.json. Restart the client once; every npx run after that skips setup.
text "Find unanswered DMs from today, draft a reply for each, send only after I confirm."
The setup link expires in 10 minutes and the code is single use. Prefer to manage a key yourself, for CI, Docker, or a shared machine? Generate one from Settings → API Keys and set INSTANTREPLY_API_KEY instead. Read the spec at RFC 8628.
Tools · up to 114
Annotated for safe agents.
Every tool advertises readOnlyHint and destructiveHint. Compliant agents ask before they write.
get_connection_guideHow to connect each channel, no key requiredreadadd_channel_group_knowledgeAdd a FAQ, product, policy, or general fact to one group braindestructiveadd_comment_ai_instructionAdd an AI instruction (a custom prompt) for comment replies and the DMs they startdestructiveadd_knowledge_entryTeach the account's AI one factdestructiveapprove_whatsapp_group_join_requestsApprove or reject WhatsApp group join requestsdestructiveask_barqAsk Barq, the InstantReply in-product agent, to do or explain anything in the account (campaigns, templates, comment rules, leads, setup)destructiveask_ownerAsk the owner a yes/no question and wait brieflydestructiveassign_channel_groupAssign one connected account to a channel group, or pass null to use the workspace AI braindestructiveassign_conversationAssign or unassign a conversation to a team memberdestructivecheck_journey_statusCheck delivery status and failure explanation for a journey enrollmentreadclose_conversationClose an active conversationdestructiveconfirm_spreadsheet_importSave a list analysed by import_spreadsheet: target "contacts" adds new customers (numbers already saved are skipped); target "campaign" adds them to a WhatsApp campaign audience through the same compliance checks as a dashboard upload (people the sheet marks as having said no are left out)destructiveconnect_channelCreate a secure browser handoff for an owner to connect another Instagram account, Facebook Messenger Page, or WhatsApp Business numberdestructivecreate_broadcast_draftCreate a WhatsApp broadcast draft for one selected sending number and template, targeting saved contactsdestructivecreate_channel_groupCreate an AI brain groupdestructivecreate_journeyCreate a WhatsApp journey from verified templates and delaysdestructivecreate_keyword_automationCreate a DM automation on one connected channeldestructivecreate_partner_accountPartner accounts only: create a client workspace (sub-account)destructivecreate_whatsapp_connect_linkPartner accounts only: create a one-time link the client opens to connect their WhatsApp number to their workspace through Metadestructivecreate_whatsapp_groupCreate a WhatsApp groupdestructivedecide_approvalApprove or decline an action Barq proposeddestructivedelete_channel_ai_providerRemove an ElevenLabs or custom reply provider override from exactly one group or channeldestructivedelete_channel_group_knowledgeDelete one knowledge entry from a group braindestructivedelete_comment_ai_instructionDelete an AI instructiondestructivedelete_keyword_automationDelete an automation rule in this workspacedestructivedelete_knowledge_entryDelete one knowledge entrydestructivedelete_templateDelete a WhatsApp template from Meta and remove the local registry rowdestructivedraft_lead_magnetGenerate a grounded lead-magnet guide for an Instagram post using user-provided source material or saved knowledgedestructiveestimate_broadcastRead live WhatsApp broadcast audience eligibility, provider cost and limits for a saved templatereadexplain_delivery_failureExplain a Meta/WhatsApp delivery or template error code in plain English with next stepsreadget_ai_instructionsRead how the account's AI talks and what it is told about the business: business_name, tone, language, custom_prompt, company_info, faqs, important_links, additional_context, preferred_phrases, banned_words, emoji_usage, escalation_keywords, plus `version` for update_ai_instructionsreadget_analytics_summaryGet inbox analytics: message volume, response times, AI usage, conversion statsreadget_broadcastRead one WhatsApp broadcast before describing delivery progressreadget_commentGet a single tracked comment by IDreadget_comment_automation_settingsRead every comment automation setting for the workspace: whether AI replies and comment-to-DM are on, how bad comments are handled (moderation action review / hide / delete), blocked words, sensitivity, reply style, cooldown, keyword rules (including rules scoped to one connected page) and the AI instructionsreadget_contactGet a single contact by IDreadget_conversationGet a single conversation by ID, including customer details and last messagereadget_developer_capabilitiesShow which API/MCP capabilities are allowed by the current API key scopesreadget_developer_limitsGet API rate limits, API key quota, and webhook endpoint quota for the current keyreadget_developer_onboardingGet the developer onboarding checklist for the current workspacereadget_journeyRead an existing journey with its mapped templates and delays before editingreadget_owner_answerCheck the result of a previous ask_owner requestreadget_partner_accountPartner accounts only: one client workspace with its connected WhatsApp numbers (phone number id, display number, verified name and review status, quality rating)readget_pipeline_leadRead a buyer lead and its linked conversation before qualification or follow-upreadget_templateGet one stored WhatsApp template by InstantReply template IDreadget_usageGet API usage stats for the current workspace: request counts, error rates, top endpointsreadget_whatsapp_group_invite_linkGet or reset the invite link for a WhatsApp groupdestructiveimport_spreadsheetUnderstand a contact spreadsheet (Excel .xlsx, CSV, TSV, a pasted table or list of numbers, or a Google Sheets link shared as "anyone with the link can view")readlaunch_broadcastQueue a WhatsApp broadcast only after the user has reviewed the exact template, account, recipient limit, maximum provider cost and preflight result and explicitly authorized sendingdestructivelist_broadcastsList real WhatsApp broadcast campaigns and their current statuses and delivery countsreadlist_channel_ai_providersList provider connections configured for exactly one group or channelreadlist_channel_group_knowledgeList verified business knowledge scoped to one channel groupreadlist_channel_groupsList channel groups and their independent AI brain configurationreadlist_channelsList every connected account (each Instagram account, WhatsApp number, and Facebook Messenger page) with its integration_id, group, and AI-reply statusreadlist_comment_ai_instructionsList the owner's AI instructions for comments: custom prompts that steer how the AI replies to comments (and the DMs they start) on one post, a few posts, every post published from now on, or every post, for every connected account or onereadlist_comment_postsList the recent posts of one connected Instagram account (newest first) with caption, link, thumbnail, comment count and publish timereadlist_commentsList Instagram/Facebook post comments tracked by Instant Replyreadlist_contactsList contacts (leads) in the workspacereadlist_conversationsList inbox conversationsreadlist_journey_historyList recent WhatsApp journey enrollments and delivery statesreadlist_journeysList real WhatsApp journeys including drafts, active and paused flowsreadlist_keyword_automationsList keyword DM automation rulesreadlist_knowledgeList what the account's AI knows: every knowledge entry it can answer from (id, type, title, content), newest firstreadlist_knowledge_gapsList real customer questions the AI could not answer, grouped, most asked firstreadlist_lead_magnet_sourcesList saved business knowledge snippets that can ground a lead magnetreadlist_lead_magnetsList hosted lead-magnet guides and their actual page/rule status and metricsreadlist_messagesList messages in a conversationreadlist_partner_accountsPartner accounts only: list your client workspaces (sub-accounts) with id, name and statusreadlist_pending_approvalsList actions Barq proposed that are waiting for a human decision (id, title, summary, risk, expiry)readlist_pipeline_leadsList actual buyer leads with saved stage and scorereadlist_pipeline_stagesRead the workspace pipeline stages before changing a lead stagereadlist_templatesList WhatsApp templates with status, category, language, components, and optional usage statsreadlist_whatsapp_groupsList WhatsApp groups for the connected business numberreadmove_pipeline_leadMove one existing lead to an authorized pipeline stagedestructivenotify_ownerSend the workspace owner an update on WhatsAppdestructiveopen_workspaceOpen the interactive Instant Reply workspace inside compatible chat hostsreadpause_lead_magnetPause a specific Instagram post lead magnet and its automated replies after user authorizationdestructivepreflight_broadcastBuild/check a broadcast audience snapshot, template, delivery eligibility, cost and riskdestructivepreview_lead_magnetPreview the hosted guide, exact public/private reply, post, grounding checks and keyword conflicts before publicationreadpropose_follow_up_ruleAsk Barq to propose a no-reply follow-up rule for owner reviewdestructivepropose_knowledge_entryAsk Barq to propose a knowledge entry for owner reviewdestructivepublish_lead_magnetPublish a public guide and activate its comment-to-DM rule only after showing the exact preview and obtaining user authorizationdestructivereact_to_messageAdd, change, or remove a reaction on an inbound WhatsApp messagedestructiveread_owner_messagesRead free-text messages the owner sent to your agent through WhatsAppreadrecommend_planGet a fit recommendation for the workspace from what you learn about the business in conversation — channels they want, expected monthly message volume, team size, and whether they need API/webhook accessreadremove_whatsapp_group_participantsRemove people from a WhatsApp group by phone numberdestructivereplace_journey_stepsReplace every step in a selected WhatsApp journey after showing the complete new sequence and obtaining authorizationdestructivereply_to_commentPost a public reply to an Instagram/Facebook comment (POST /v1/comments/:id/reply, needs messages:send)destructivesend_messageSend text or an HTTPS-hosted image, document, audio, or video attachment in a conversation on Instagram, WhatsApp, or Messenger (messages:send)destructivesend_whatsapp_group_messageSend plain text or an approved template to a WhatsApp groupdestructivesend_whatsapp_templateTrigger a WhatsApp journey/template send by trigger_name or journey_iddestructiveset_channel_ai_providerConfigure ElevenLabs voice synthesis or a custom reply webhook for exactly one group or channeldestructiveset_channel_ai_repliesTurn AI auto-replies on or off for one connected channel (an Instagram account, WhatsApp number, or Messenger page), without touching the othersdestructiveset_channel_comment_ai_repliesTurn AI comment replies on or off for one connected Instagram or Facebook pagedestructiveset_comment_ai_repliesTurn AI auto-replies to comments on or off for the whole org (all connected Instagram/Facebook pages)destructiveset_comment_keyword_rulesReplace the workspace comment keyword trigger rulesdestructiveset_journey_statusActivate or pause a specific journey after user authorizationdestructivesubmit_stored_templateSubmit an existing stored template draft to Meta for approvaldestructivesubmit_templateCreate and submit a WhatsApp template to Meta from a flat developer-friendly shapedestructiveteach_knowledge_gapAnswer one unanswered question once: the answer becomes a knowledge entry (FAQ) and the gap is resolveddestructivetest_ai_replyPreview how the account's AI would answer a customer message right now, from its saved knowledge and instructionsreadtrigger_journeyEnroll one phone number in a WhatsApp journey by trigger_name or journey_iddestructivetrigger_journey_batchBulk-enroll up to 100 recipients into a WhatsApp journeydestructiveupdate_ai_instructionsChange how the AI talks or what it is told about the businessdestructiveupdate_channel_groupUpdate a group name, switch that group brain on/off, or change its AI reply settingsdestructiveupdate_comment_ai_instructionChange an AI instruction: its text, scope, posts, account, name, or switch it on or offdestructiveupdate_comment_settingsChange comment automation settings for the whole workspacedestructiveupdate_contactUpdate a contact name or lead stagedestructiveupdate_keyword_automationUpdate a channel automationdestructiveupdate_knowledge_entryFix or reword one knowledge entrydestructivevalidate_journey_triggerDry-run a journey trigger requestreadvalidate_templateValidate a stored WhatsApp template against Meta submission rules before submitting or rewritingreadvalidate_template_draftValidate a plain-language WhatsApp template objective before creating itreadwhatsapp_groups_eligibilityCheck if this WhatsApp number can create groupsread
Want the agent to text you on WhatsApp and ask before it deploys? See Agent Line, or read how to connect Claude Code to WhatsApp.
Prompts · 13
Slash commands for the work you already do.
MCP clients expose these prompts as reusable commands. Pair them with the downloadable InstantReply skill packs so the agent knows the approval loop, Utility rewrite rules, owner growth plays, integration runbooks, and destructive-action guardrails.
- /add_your_own_integration
- Plug your own system into InstantReply replies via a signed custom reply webhook
- /audit_template_cost
- Audit WhatsApp templates for category, approval state, and cheaper UTILITY-safe alternatives
- /debug_last_failure
- Explain the most recent WhatsApp delivery/template failure and recommend the next action
- /draft_reply
- Draft a reply to a customer message in your brand voice
- /escalation_note
- Write an internal escalation note for a difficult conversation
- /find_urgent_unanswered
- Identify urgent or unanswered messages that need immediate attention
- /image_to_whatsapp_template_brief
- Turn a provided image, campaign asset, or product screenshot into compliant WhatsApp template ideas
- /journey_recommendation
- Recommend WhatsApp journeys, trigger names, templates, and status checks for a business workflow
- /setup_instantreply
- Walk the user through connecting their social accounts to InstantReply step by step
- /suggest_macros
- Suggest canned response macros based on recent conversation patterns
- /summarize_conversation
- Summarize a conversation for a quick handoff or review
- /utility_rewrite_loop
- Plan a safe rewrite-submit-poll loop for templates that should legitimately be UTILITY
- /weekly_inbox_digest
- Generate a weekly performance digest from analytics data
Agent skills
Download the operating playbooks.
Install the MCP server for live tools, then add these skills to teach the agent how to run the business workflows: growth audits, WhatsApp policy, template creative, and developer integration.
- WhatsApp OperatorRun template approval, Utility rewrites, polling, cleanup, sends, and delivery debugging.Download →
- Business Owner GrowthFind missed leads, no-shows, support leaks, review loops, and the next useful automation.Download →
- WhatsApp Best PracticesReview templates, opt-ins, journeys, categories, quality risks, and approval loops.Download →
- API IntegrationGuide developers through scopes, webhooks, retries, idempotency, journeys, and delivery tracking.Download →
- Creative StudioTurn offers, customer events, and images into category-safe WhatsApp template briefs.Download →
Clients
Drop the block. Pick your editor.
- Claude Code
.mcp.json (project root)Setup guide → - Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonSetup guide → - Cursor
~/.cursor/mcp.jsonSetup guide → - Windsurf
~/.codeium/windsurf/mcp_config.jsonSetup guide → - Zed
Zed → Settings → Assistant → Context ServersSetup guide → - ChatGPT Actions
Custom GPT → Actions → paste route schemas from /api-docs (no public OpenAPI import)Setup guide → - Claude.ai (remote)
Settings → Connectors → Add custom connector → https://api.instantreply.co/mcp - Any MCP host
stdio transport · npx -y @instantreply.co/mcp
WhatsApp workflows · conversational
Ask instead of clicking.
The MCP server exposes the same template-lifecycle and delivery-debug APIs as conversational tools. You can drive the full workflow - validate, reword, submit, debug - without opening Meta Business Manager or reading error codes.
- Template UTILITY coaching
- Ask: "Check my pending templates and tell me which ones qualify as UTILITY." The validate_template tool returns flagged marketing phrases and category-safe rewrites. Utility templates are often cheaper than Marketing when the message is truly transactional.
- Submit to Meta
- Once the coaching is clear, ask: "Fix the flagged phrases and submit." The submit_template tool routes the corrected template to Meta and returns the approval status.
- Explain a delivery failure
- Ask: "Why did the last campaign message fail for contact X?" The explain_delivery_failure tool returns what happened, whether the fault is ours or Meta's, and whether a retry is safe.
- Developer onboarding checklist
- Ask: "What integration steps are still incomplete?" The get_developer_onboarding tool returns a checklist of which steps are done and which are not - connect channel, validate first template, register webhook.
Permissions · scopes
The key controls what the agent can do.
Every MCP tool maps to an API key scope. Read tools require conversations:read. Write tools require messages:send. Template tools require templates:write to validate and templates:submit to submit.
Use a read-only key for agent sessions that should only observe. Use a full-scope key for agents that send messages or submit templates. Both key types work with the same server config - just swap the key value.
Zero-key pairing and the remote connector sign-in mint a key with every resource scope, never the wildcard or admin scopes. Your plan still applies: Free and Creator workspaces stay read-only on every request. Want a narrower agent? Generate a dedicated key from the dashboard with only the scopes it needs.
Every tool advertises readOnlyHint and destructiveHint so compliant MCP clients ask for confirmation before any write action.
# Read-only agent: observe and debug
IR_API_KEY=ir_live_... # scopes: conversations:read
# Full agent: validate, submit, send
IR_API_KEY=ir_live_... # scopes: conversations:read,
# messages:send,
# templates:write,
# templates:submitFAQ
What agents and developers actually ask.
- Do I need an API key before I can use this MCP server?
- No. Add the config block with no env vars and ask your agent to connect. It calls start_setup, which returns a short code and a link using the same OAuth 2.0 Device Authorization Grant flow gh auth login uses (RFC 8628). Approve it in a browser, then check_setup picks up the key automatically and caches it at ~/.instantreply/config.json. Restart the MCP connection once and the full tool set loads.
- How many tools, prompts, and resources does the server expose?
- Up to 114 tools once paired - authenticated tools covering conversations, contacts, templates, journeys, and delivery debugging, including get_connection_guide, which needs no key and is always on. Before pairing there are only 3 setup/guide tools. Remote MCP plans omit the 3 hosted AI tools; directory deployments omit 3 further tools. There are also 13 prompts (slash commands like /audit_template_cost), an interactive workspace resource, and 2 resource templates, conversation and contact. Every tool declares readOnlyHint and destructiveHint so a compliant MCP client can ask before it writes or deletes anything.
- Which plans include the MCP server?
- Free gets read-only MCP tools. Creator does not include MCP. The public GitHub repository is the MIT-licensed client only; the hosted server and AI require an eligible plan. MCP Starter is $12/month ($120/year), MCP Growth $29/month ($290/year), and MCP Pro $89/month ($890/year). The MCP plans are built for bringing your own agent and model: they include the MCP tools but no InstantReply-hosted AI replies. Every Developer plan (Dev Hobby, Dev Pro, Dev Scale) and every paid Business plan (Starter, Growth, Pro) includes the full tool set, with priority MCP routing on Dev Scale and Pro.
- What's the difference between a read-only key and a full-scope key?
- A read-only key (conversations:read) can list and read conversations, contacts, analytics, templates, and usage - nothing it does changes data. Sending a message needs messages:send. Validating and submitting templates need templates:write and templates:submit. Zero-key pairing and the remote connector sign-in mint a key with every resource scope (never the wildcard or admin scopes), so template tools work after pairing. Free and Creator workspaces are still limited to read-only on every request.
- Does this work with ChatGPT?
- Yes, two ways. Add the remote connector URL (https://api.instantreply.co/mcp) in ChatGPT's connectors with developer mode on and sign in, or build a Custom GPT action from the route schemas on the REST catalog (the production API does not serve a public OpenAPI file). The local stdio server is for terminal clients like Claude Code, Cursor, Windsurf, and Zed.
- Can I connect without installing anything?
- Yes. In Claude.ai go to Settings → Connectors → Add custom connector, paste https://api.instantreply.co/mcp, and sign in to InstantReply. Approve the consent screen, which shows who is asking and lets you revoke access any time in Settings → API keys. ChatGPT works the same way through connectors in developer mode. In Claude Code run: claude mcp add --transport http instantreply https://api.instantreply.co/mcp, then type /mcp to sign in. In Cursor add {"mcpServers": {"instantreply": {"url": "https://api.instantreply.co/mcp"}}} to ~/.cursor/mcp.json, then connect it in Cursor Settings → MCP. In Codex run: codex mcp add instantreply --url https://api.instantreply.co/mcp, then codex mcp login instantreply to sign in. Yearly plans start with a 7-day free trial of the selected plan, card required, and nothing is charged until day 8. Monthly plans have no trial.
- Will the agent send a message or delete something without asking me first?
- Every write and destructive tool - send_message, submit_template, delete_template, and the rest - advertises destructiveHint: true in its MCP tool metadata. A compliant client prompts for confirmation before running it. The server executes the call when the client sends it; it does not silently auto-send on its own.
The model is ready. The tools are wired.