How to use the Larkpulse MCP
The Larkpulse MCP lets you run your social media from the AI assistant you already use, such as Claude, ChatGPT, Perplexity, Cursor or Claude Code. Connect it once and you can just ask:
- “What were my best posts this week, and why did they work?” Your AI pulls your analytics across every channel and ranks your top posts.
- “Write a LinkedIn post about our launch, make an image for it and schedule it for Tuesday at 9am.” Your AI drafts the post in your brand voice, generates the image and puts it in your calendar.
- “Show me new comments and draft replies.” Your AI reads your inbox and drafts on-brand replies, and only posts the ones you approve.
Why use it
- One conversation instead of many tabs. Plan, write, design, schedule, analyse and reply without switching between apps or platforms.
- It knows your brand. Your AI uses your Larkpulse Brain, personas, styles, brand kits and CTAs, so its posts and images sound and look like you.
- All your channels in one place. Facebook, Instagram, LinkedIn, Threads, X, YouTube, TikTok and Pinterest work through the same connection.
- You stay in control. Everything lands in your Larkpulse workspace, where your team can review drafts, the calendar and the Media Library. Your AI shows you replies before posting them.
- Your whole team can use it. Everyone on the workspace connects their own AI and shares the plan’s monthly allowance.
How MCP calls are counted
When your AI does something in Larkpulse, such as reading your analytics, replying to a comment or scheduling a post, that action is a tool call. Your plan includes a set number of calls each month.
The basics
- One successful action = one call. A single conversation can use several. For example, “write a LinkedIn post about our launch, make an image for it and schedule it for Tuesday” might list your accounts, generate the post, generate an image, then schedule it. That’s 4 calls.
- Posting to several accounts at once is still one call. Publishing the same post to 5 channels counts once.
- Failed calls are free. If something goes wrong, nothing is counted.
- Checking on things is free. Your AI can check a post’s publish status or an image’s or carousel’s progress as often as it needs to.
- One upload = one call. Getting an upload link is free. The call is counted when the file is saved to your Media Library.
- Adding your CTA is included. When your AI adds one of your saved comment CTAs to a post, it’s part of that post’s call.
- Replies on X also use X credits. A reply on X costs the same X credits as publishing a post.
Free (doesn’t count)
| Action | What it does |
|---|---|
| List workspaces | Finds the workspaces you can access |
| Check a post | Gets a post’s publish status for each account, any errors, and a link to it |
| List comment CTAs | Shows your saved calls to action that can be added as a first comment |
| Image options | Lists image models, styles and brand kits you can use |
| Check an image | Shows progress and returns the finished images |
| Carousel options | Lists the carousel designs, brand kits and CTAs you can use |
| Check a carousel | Shows a carousel’s progress and slides |
| Get an upload link | Prepares a direct file upload (the finished upload counts) |
1 call each
| Area | Actions |
|---|---|
| Workspaces & channels | List connected social accounts, list Pinterest boards |
| Analytics | Get metrics for one account or your whole workspace over any date range, including your top posts with each post’s stats |
| Content calendar | Browse drafts, scheduled and published posts; list content categories |
| Brain | List and read Brain insights; list sources |
| Writing with AI* | Generate a post, improve a post, adapt a post for other channels, write follow-up comments; list personas and AI models |
| Images* | Generate up to 4 AI images in one request, with your styles, captions and brand kits |
| Carousels* | Generate a carousel, edit a carousel |
| Inbox | Read your comments and mentions, reply, and ignore, hide or approve comments |
| Inbox drafts* | Draft an on-brand reply to a comment |
| Media | Upload an image, video or PDF to your Media Library |
| Publishing | Save a draft, publish now, schedule, or add to a content category queue, with optional first comments and your saved comment CTA |
Shared across your team and the API
- The monthly limit comes from the workspace owner’s plan, and everyone on the team uses the same pool.
- REST API requests use the same pool and follow the same rules.
When it resets
Usage resets on the 1st of each month (UTC). Unused calls don’t carry over.
What happens at the limit
Your AI gets a message saying the monthly limit has been reached. Calls work again on the 1st, or right away if the workspace owner upgrades to a higher plan.
Where to see your usage
Go to Settings → Billing. Your calls this month appear in the Current Plan card and in the Connect your AI section.
Finding your best posts
Ask your AI something like “what were my best posts this week?” and it gets your top posts with their stats in one call. It can return up to 50 posts, ranked by engagement, impressions, likes, replies, shares or clicks. Each post comes with its impressions, reach, clicks, likes, reposts, replies, shares, saves and engagement rate, plus a link to the post.
This includes posts you published directly on each platform, not just ones sent through Larkpulse. You can ask about one account or your whole workspace, for any date range.
Replying to comments
Ask your AI something like “show me new comments from this week and draft replies”. It reads your inbox for one call and can draft on-brand replies, each draft costing one call plus AI credits. It then posts the replies you approve, one call each.
- Your AI shows you each reply before posting it. You stay in control of what goes out under your name.
- It works with Facebook, Instagram, LinkedIn Pages, Threads, X and YouTube. Replies are text only.
- Your AI can ignore comments, which removes them from your inbox. Where the platform allows, it can also hide or unhide them, or approve replies held for approval. It can’t delete comments.
Not finding what you are looking for?
Contact us