MCP

Larkpulse MCP server

Run your social media from the AI assistant you already use. The Larkpulse MCP server connects Claude, ChatGPT, Perplexity, Cursor and command-line agents to your Larkpulse workspace, so they can plan, write, design, schedule and publish posts, read your analytics and help you reply to comments.

New to MCP? The step-by-step guide explains what you can do and how calls are counted.

Connection details

Server URL
https://app.larkpulse.com/api/mcp
Transport
Streamable HTTP
Authentication
OAuth 2.1 with PKCE and dynamic client registration. Sign in once with Larkpulse, no API keys.
Plan
Larkpulse Pro or above (Pro includes 1,000 MCP calls a month, Business 3,000).

The server is hosted by Larkpulse; there is nothing to install. AI agents can read the connect guide to learn the workflow.

Set up your AI assistant

Claude

  1. Open Settings → Connectors and click Add custom connector.
  2. Paste the server URL, click Connect, then sign in with Larkpulse and approve.

Claude Code

  1. Run the command, then approve the browser sign-in.
claude mcp add --transport http larkpulse https://app.larkpulse.com/api/mcp

ChatGPT

  1. On ChatGPT web, open Plugins (chatgpt.com/plugins), click + and choose Add custom MCP server.
  2. Name it Larkpulse, paste the server URL under Connection, set authentication to OAuth, accept the risk warning and select Create as a plugin.
  3. Click Sign in with Larkpulse and approve.

Custom MCP servers with full access need a ChatGPT Business or Enterprise/Edu workspace whose admin allows them. ChatGPT Pro accounts can connect with read-only access, so posting tools aren't available there.

Perplexity

  1. Open Settings → Connectors, add a custom MCP connector with the server URL and authorize with Larkpulse.

Cursor

  1. Open Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json), paste the config and approve the browser sign-in.
{
  "mcpServers": {
    "larkpulse": { "url": "https://app.larkpulse.com/api/mcp" }
  }
}

OpenClaw

  1. Stop the OpenClaw Gateway first: adding a server needs it stopped.
  2. Run the commands in an interactive terminal. The login step opens a browser to sign in with Larkpulse.
  3. Start the Gateway again (or start a new session) so the agent picks up the tools. They appear as mcp_larkpulse_*.
openclaw mcp add larkpulse --url https://app.larkpulse.com/api/mcp --transport streamable-http --auth oauth
openclaw mcp login larkpulse
openclaw mcp doctor larkpulse --probe

Hermes

  1. Run in an interactive terminal, then use /reload-mcp in the agent and confirm with hermes mcp list.
hermes mcp add larkpulse --url https://app.larkpulse.com/api/mcp --auth oauth

What you can ask

  • “What were my best posts this month, and what do they have in common?”
  • “Write a LinkedIn post about our launch, make an image for it and schedule it for Tuesday at 9am.”
  • “Turn this post into a carousel and save it as a draft.”
  • “Show me new comments and draft replies.”

Tools

Every tool is annotated so your assistant knows which ones only read, which change your Larkpulse data and which act on a social platform. Assistants should ask you before publishing, replying or moderating.

Workspaces and channels

list_workspacesWorkspaces you can access and your role in each.Read
list_accountsConnected social accounts, with each account's character limit.Read
list_pinterest_boardsBoards for a connected Pinterest account.Read
list_content_categoriesContent category queues and their posting slots.Read
list_personasPersonas for AI writing.Read

Analytics and calendar

get_analyticsMetrics for one account or the whole workspace, including your top posts.Read
get_calendarDrafts, scheduled and published posts over a date range.Read
get_postOne post's publish status, errors and links for each account.Read

Brain

list_sourcesUploaded source documents and their insight counts.Read
list_brain_insightsStories, facts, ideas and other insights from your Brain.Read
get_brain_insightsFull text of selected insights.Read

Writing with AI

list_generate_modelsAI models and their credit cost.Read
generate_postWrite post copy from a brief or Brain insights. Saves nothing.Changes Larkpulse
improve_postPolish your draft for each channel. Saves nothing.Changes Larkpulse
magic_adaptAdapt a post to other channels. Saves nothing.Changes Larkpulse
generate_first_commentsWrite follow-up comments for a post. Saves nothing.Changes Larkpulse

Images and carousels

list_image_optionsImage models, styles and brand kits.Read
generate_imageGenerate up to 4 AI images, saved to your Media Library.Changes Larkpulse
get_imageCheck an image job and get the finished images.Changes Larkpulse
list_carousel_optionsCarousel designs, your styles, brand kits and CTAs.Read
generate_carouselCreate a 3 to 9 slide carousel from post text.Changes Larkpulse
get_carouselCheck a carousel's progress and slides.Read
edit_carouselChange a carousel in plain language.Changes Larkpulse

Media

upload_mediaAdd an image or video to your Media Library from a URL or chat attachment.Changes Larkpulse
create_media_uploadGet a direct upload link for local files (command-line agents).Changes Larkpulse
finalize_mediaSave a file uploaded through a direct upload link.Changes Larkpulse

Posting

list_comment_ctasSaved calls to action you can add as a first comment.Read
save_draftSave a post as a draft in your calendar.Changes Larkpulse
schedule_postSchedule a post for a future time.Acts on platform
add_to_categoryQueue a post into a content category's next slot.Acts on platform
publish_postPublish a post now to one or more accounts.Acts on platform

Inbox

get_inboxComments, replies and mentions on your posts.Read
draft_comment_replyDraft an on-brand reply for you to review. Posts nothing.Changes Larkpulse
reply_to_commentPost a reply you've approved.Acts on platform
moderate_commentIgnore, hide, unhide, approve or reject a comment.Acts on platform

Prompts

Ready-made workflows your assistant can offer as starters or slash commands.

  • plan_week_of_posts · Draft a week of posts from your Brain and save them as drafts for review.
  • repurpose_to_channels · Adapt one post to each connected channel.
  • carousel_from_post · Turn a post into an AI carousel and attach it to a draft.
  • analytics_recap · Summarise performance and your best posts, with ideas for what to post next.
  • reply_to_comments · Draft replies to new comments for you to approve.

Usage and AI credits

Each successful action counts as one MCP call against the workspace owner's monthly allowance. Checking a post, image or carousel is free, and failed calls are never counted. Writing and image tools also use AI credits, or your own OpenRouter or fal.ai keys. See how MCP calls are counted.

Security and privacy

  • You sign in with Larkpulse and approve each assistant. It gets the same access you have, nothing more.
  • Access tokens expire after an hour. You can revoke any assistant in Larkpulse under Settings → Billing → Connected apps.
  • Data the assistant reads, such as analytics or comments, is shared with that assistant's provider. Read the AI assistants section of our privacy policy and our terms of service.

Support

Questions or problems connecting? Email [email protected] or use our contact form.