dmswift MCP server
Provides tools for Facebook Pages, including Page comments and messaging; the README notes Facebook Pages support is coming soon for new accounts pending Meta approval.
Enables AI agents to manage Instagram professional accounts: publish and schedule posts, reels, stories, and carousels; run comment-to-DM campaigns; moderate and reply to comments; handle direct messages within Meta's 24-hour window; and read account and post insights.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
dmswift MCP server: Instagram and Facebook Pages for AI agents
dmswift is a hosted (remote) Model Context Protocol server that lets an AI agent run a business's Instagram professional account through Meta's official API: publish and schedule posts, reels, stories and carousels, run comment-to-DM campaigns, answer comments and direct messages, and read insights.
It works with Claude, Claude Code, ChatGPT, Cursor, Gemini, Grok, Perplexity, VS Code, n8n and any other MCP client that can reach a remote server.
https://app.dmswift.com/mcpTransport: Streamable HTTP (stateless, no SSE endpoint)
Auth: OAuth 2.1 with dynamic client registration and Client ID Metadata Documents, or an API key as a bearer token
Tools: 44, each with MCP annotations (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint)Nothing to install or host. There is no package to run and no Meta developer app to create. You sign in, connect your Instagram account, and paste the URL into your agent.
Platform status. Instagram professional accounts (Business and Creator) are fully open. Facebook Pages are coming soon for new accounts, once Meta approves Page messaging for the app. Facebook groups and personal Instagram accounts are not supported by Meta's API.
This repository holds the public documentation, client configuration examples and prompts for the server. The server itself is a hosted service; its source is not in this repository.
Contents
Related MCP server: meta-mcp
What an agent can do
Area | What the agent does |
Publishing | Draft, schedule and publish feed photos, carousels (2 to 20), reels and stories. Draw text-on-background images without an image generator. |
Comment to DM | Create a campaign: someone comments a keyword on a post or reel, gets a public reply and one private message with your link. Also triggers on DMs, story replies and mentions. |
Comments | List comments, reply publicly, hide spam (reversible), delete when asked. |
Inbox | Read conversations and reply inside Meta's 24-hour window, never while a person on your team took the conversation over. |
Insights | Reach, views, followers and engagement per account and per post, campaign results, best times to post, and the questions nobody answered yet. |
Contacts and knowledge | Search and tag the people who engaged, and read or add facts about the business so replies do not guess. |
Quick start
Create an account at dmswift.com. The 7-day trial needs no card.
Connect your Instagram professional account with Instagram's own login. See how to connect Instagram.
Add
https://app.dmswift.com/mcpto your AI client (next section) and sign in when it asks.On the consent screen choose which channels the agent sees, what it may do (Read only, Read + draft, or Full), and whether every publish waits for your approval.
Ask your agent: "List my channels on dmswift and tell me what you are allowed to do today."
Connect your client
Client | How |
Claude (web, desktop, mobile) | Customize, Connectors, Add custom connector. Name it dmswift, paste the URL, Connect, then sign in. Guide |
Claude Code |
|
ChatGPT | chatgpt.com/plugins, +, Add custom MCP server, the URL, authentication OAuth. In a chat type |
Cursor |
|
VS Code (Copilot agent mode) |
|
Gemini | gemini.google.com, Settings, Connected Apps, Custom apps, Add a custom app. Guide |
Grok | grok.com/connectors, New Connector, Custom. Guide |
Perplexity | Plugins, Add custom, Connector, Add MCP connector, Remote. Guide |
n8n, Make, Zapier | The MCP Client node, module or app with the URL and an API key as a Bearer token. Guide |
Any other MCP client | Remote server, Streamable HTTP, the URL above. OAuth if the client supports it, otherwise an API key. See examples/generic-api-key.json |
API keys are created in the dashboard on the AI agents page. A key is weaker than the account that made it: it holds only the scopes you grant, can be pinned to specific channels, has daily caps, and cannot reach billing, the team or key management.
Tools
Only the tools the connection's scopes allow are registered. Read tools are free; each write counts as one agent action against the plan's monthly allowance.
Account and channels
Tool | What it does |
| Permissions, channels, approval mode, daily caps left, plan and monthly usage |
| The channels this connection may act on. Call it first |
| Whether a channel can publish |
Posts and media
Tool | What it does |
| Posts in dmswift and live posts and reels straight from the platform |
| Drafts and scheduled posts, with media, alt text, a first comment and an attached campaign |
| Put a post live. Supports |
| Media by public URL, by a one-time upload page for the user's own photos, or small base64 files |
| The server draws text-on-background images (single or carousel) in the channel's brand look |
Campaigns (comment to DM, DM keywords, story replies, mentions)
Tool | What it does |
| Campaigns with hit counts |
| Keyword rules with a public reply and a private message, per-person limits, caps, quiet hours and delays |
| Dry-run a sample comment against the campaigns before anything is live |
Comments
Tool | What it does |
| Comments on live posts, newest first |
| Public replies (liking and commenting as the Page are Facebook only) |
| Moderation. Hiding is reversible and preferred |
Inbox
Tool | What it does |
| Conversations with |
| A private reply inside Meta's 24-hour window |
Results
Tool | What it does |
| Campaign totals, what the automation did and whether it worked, the funnel and best times to post |
| Comments that matched no campaign, ranked by how often they were asked |
| Meta's reach, views, followers and engagement |
Contacts and knowledge base
Tool | What it does |
| The people who engaged, searchable and taggable |
| What the business wrote about itself: prices, hours, policies |
The full reference, with scopes, arguments and error codes, is in the API and MCP documentation.
Prompts and resources
Prompts:
launch_comment_campaign_for_latest_post,weekly_performance_reportResources:
dmswift://docs/agent-guide(how to use the server),dmswift://pages(the channels)
Safety model
An agent that can publish needs limits that do not depend on the agent behaving well. These are enforced by the server:
Scopes. Drafting (
posts:write) and publishing (posts:publish) are separate. Read only, Read + draft and Full are one-click presets on the consent screen.Approval mode. Tick "Ask me before anything is published" and every publish waits for a person in the dashboard. The tool returns
pending_approval, which is a success, not an error to retry.Daily caps per connection. By default 15 publishes, 30 comment replies and 100 private messages a day. A spent cap returns
daily_capwithresets_at.Channel pinning. A connection can be limited to one account.
Idempotency.
create_post,reply_to_commentandreply_to_conversationaccept anidempotency_key, so a retried call never double-posts.Errors that say what to do. A failed call carries
next_step, one sentence the model can act on.Audit and disconnect. Everything an agent did is in the activity log, and Disconnect on the AI agents page ends a connection at once.
More on security at dmswift.
Meta's rules the server enforces
One private reply per comment, within 7 days of the comment (Private Replies).
The 24-hour window. After that, more messages only if the person answers, within 24 hours of their answer (Instagram messaging).
Nobody is messaged who did not write first. There are no cold DMs and no bulk messages to followers.
Publishing cap. 100 API-published posts per Instagram account in a moving 24 hours (Content publishing).
Instagram media cannot be deleted through the API.
delete_postremoves it from dmswift only.
Example prompts
More in examples/prompts.md.
Make a comment campaign on my newest reel: whoever comments GUIDE gets a short public reply
and a DM with https://example.com/guide, once per person. Test it before you tell me it is live.Look at my last 10 Instagram posts and summarize the style. Then draft a carousel about
[topic] in the same voice, show it to me, and schedule it for tomorrow at 12:30 if I approve.Show me the questions in my comments that nobody answered this week, ranked by how often
they were asked, and suggest a campaign for the top three.Go over the open conversations from the last 24 hours. Who asked about price or availability
and is still waiting? Suggest a reply for each and send nothing until I say so.Pricing
MCP and API access are included in every plan, from Starter at $19 a month. The 7-day free trial runs on the Pro plan and needs no card. Current plans and limits: dmswift.com/pricing.
FAQ
Do I need a Meta developer account or my own Meta app? No. dmswift is the approved app. You sign in with Instagram and grant access in Instagram's own dialog.
Does it work with a personal Instagram account? No. Meta's API only covers professional accounts (Business or Creator). Switching is free and takes a minute in the Instagram app.
Is this scraping or browser automation? No. Every call goes through Meta's official Graph API with the permissions you granted. The agent never sees your Instagram password.
Can the agent DM anyone it wants? No. It can message only people who commented, replied to a story, mentioned you or wrote to you, and only inside the windows Meta allows.
Can I self-host it? No. It is a hosted service. That is what removes the Meta app review, token handling and webhook hosting from your side.
How is it different from ManyChat? ManyChat is built around a visual flow builder that a person operates. dmswift has a dashboard too, but it is built so that an AI agent can do the same work through MCP, with scopes, approval mode and daily caps. A side by side comparison: dmswift vs ManyChat.
Links
Website: dmswift.com
MCP overview: dmswift.com/mcp
Instagram MCP server: dmswift.com/mcp/instagram
API and MCP reference: dmswift.com/docs
Guide, auto DM people who comment: dmswift.com/guides/auto-dm-instagram-comments
Machine-readable summary: dmswift.com/llms.txt
Support: support@dmswift.com
License
The documentation and examples in this repository are released under the MIT License. dmswift, the hosted service, is a commercial product.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Instagram MCP for DM and comment automation, AI Agent and content publishing via Meta's official API
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Publish and schedule Instagram posts, Reels and carousels from your AI assistant.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Instagram Business accounts by automating content publishing, scheduling posts, and analyzing performance metrics. Supports posts, stories, reels, and carousels with detailed audience insights and hashtag discovery.1-
- AlicenseAqualityCmaintenanceEnables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API.5994 npm14MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI applications to interact with Instagram Business accounts through Meta's Graph API, including profile retrieval, media publishing, insights, comments, conversations, and direct messaging.-
- FlicenseNot gradedqualityAmaintenanceEnables AI applications to interact with Instagram Business accounts through Meta's Graph API. Supports retrieving profile details, media posts, and engagement insights, publishing images and videos, and reading or replying to direct messages (with Advanced Access).-