ReeplDOCS

MCP Connectors Reference

Complete reference for all 55 Reepl MCP tools — what each tool does, its constraints, and how to use them from Claude Desktop, ChatGPT, Cursor, or OpenClaw

The Reepl MCP server exposes 55 tools that let you manage your LinkedIn and Twitter content, contacts, carousels, analytics, workspace/team data, and more from any MCP-compatible AI client. This page is the complete tool reference. For setup instructions, see How to Connect Reepl via MCP.

MCP requires a Premium plan. Supported clients: Claude Desktop, ChatGPT, Cursor, OpenClaw.

Key constraints

Before using the tools, note these hard limits enforced by the underlying platforms:

  • LinkedIn posts: Maximum 3,000 characters. Plain text only — LinkedIn does not render markdown, so asterisks, underscores, and other markdown syntax appear as literal characters in the published post.
  • Comments: Maximum 1,250 characters. Comments are not supported on reshares or restricted posts.
  • Tweets: Maximum 280 characters per tweet. Polls cannot be combined with threads or media attachments.
  • Carousel slides: Maximum 10 slides per carousel.
  • Pagination: get_published_posts, get_scheduled_posts, get_contacts, get_list_contacts, and get_ideas all use cursor-based pagination via a nextToken field.

Draft management

ToolWhat it does
create_draftCreate a new LinkedIn post draft
get_draftsList drafts with optional search query
update_draftEdit the content or title of an existing draft
delete_draftRemove a draft permanently

Publishing and scheduling

ToolWhat it does
publish_to_linkedinPublish a post immediately (max 3,000 chars, plain text only). Optional first_comment posts a follow-up comment right after publishing
schedule_postSchedule a post for a future time (ISO 8601 timestamp, rounded to the nearest 15 minutes). Optional first_comment posts a follow-up comment when the post goes live
schedule_draftSchedule an existing draft for a future time
update_scheduled_postModify a scheduled post's time, content, or visibility
delete_scheduled_postCancel a scheduled post
publish_nowForce immediate publishing of a scheduled post

Plain text only for LinkedIn. Do not ask your AI client to include markdown in a LinkedIn post — bold, bullet points, and other formatting will appear as raw symbols in the published content.

Content retrieval

ToolWhat it does
get_published_postsRetrieve published posts with pagination and optional search. Optional member_user_id filters to a specific teammate's posts in a shared workspace
get_scheduled_postsGet queued posts with optional status filtering. Optional member_user_id filters to a specific teammate's posts in a shared workspace
get_user_profileRetrieve your Reepl account information

Post engagement

ToolWhat it does
read_linkedin_postRead any public LinkedIn post by URL — author, text, like/comment counts, and the post's urn
add_comment_to_postComment on a LinkedIn post (max 1,250 chars) — your own post by postId, or any public post by the urn returned from read_linkedin_post

Comments are not supported on reshared posts or posts with restricted commenting. If a comment fails, the post type is the likely cause — not a connection issue.

ToolWhat it does
generate_carousel_contentAI-generate slide content from a topic or URL
list_carousel_draftsList all saved carousel drafts
get_carousel_draftFetch a specific carousel draft by ID
create_carousel_draftSave a carousel (brand kit applied automatically if no theme is specified)
update_carousel_draftEdit slides, theme, or fonts on an existing carousel
delete_carousel_draftRemove a carousel draft
list_carousel_templatesList your saved "My Templates" carousel templates

Carousels support up to 10 slides. When creating a carousel without specifying a theme, your brand kit settings are applied automatically. Use list_carousel_templates to find a saved template ID, then pass it to create_carousel_draft to apply it.

Contacts and lists

ToolWhat it does
get_contactsSearch or list contacts with pagination
get_listsList your contact lists
get_list_contactsFetch contacts within a specific list
add_contact_to_listAdd a contact to a list

Workspace and team

ToolWhat it does
list_workspacesList every workspace/organization you belong to, with your role and which one is default
set_default_workspaceSwitch your default Reepl workspace
get_workspace_contextGet the active workspace's brand context and your personal positioning
get_audience_profilesList the workspace's saved audience profiles (ICPs)
list_workspace_membersList members of the current workspace with their user ID, role, and status
get_workspace_postsGet the whole workspace/team post queue, annotated by author

These tools are most useful on Team and Agency plans, where multiple members share a workspace. On a solo workspace, list_workspaces returns a single entry and get_workspace_posts behaves the same as get_scheduled_posts.

Collections and templates

ToolWhat it does
get_collectionsBrowse your saved post collections
get_saved_postsRetrieve posts within a collection
get_templatesRetrieve saved post templates and ideas

Twitter / X

ToolWhat it does
twitter_create_postCreate or schedule a tweet or thread (280 chars per tweet; supports polls)
twitter_create_draftSave a tweet as a draft
twitter_update_draftEdit a tweet draft
twitter_delete_draftRemove a tweet draft
twitter_get_postsRetrieve published, scheduled, or failed tweets
twitter_get_draftsList tweet drafts
twitter_update_postModify a scheduled tweet's content or time
twitter_delete_postCancel or delete a tweet

Twitter / X tools require a connected Twitter account in Settings > Integrations > Twitter. Each tweet in a thread is limited to 280 characters. Polls, quote tweets, and threads are supported — but polls cannot be combined with threads or media.

Analytics

ToolWhat it does
get_post_analyticsPer-post engagement metrics for a LinkedIn post
get_linkedin_analyticsAggregate LinkedIn stats across a time range
twitter_get_analyticsAggregate Twitter / X analytics

AI and voice

ToolWhat it does
generate_imageGenerate an AI image in one of 8 styles
get_voice_profileRetrieve your voice profile with learned writing patterns
update_voice_profileModify your user instructions or AI-learned profile
get_writing_styleRetrieve your trained per-surface writing styles (posts, comments, messages)
train_writing_style(Re)train a writing-style facet — posts or comments — from your recent activity

Available image styles: infographic, minimal-illustration, bold-text, screenshot-social-proof, comic-storyboard, realistic-portrait, diagram-flowchart, custom.

Image generation requires a Gemini API key linked in Settings > AI Models & API.

Voice profile sessions are stateless — if you want your AI client to write in your style, ask it to fetch your voice profile at the start of the conversation. get_writing_style / train_writing_style are more granular than get_voice_profile / update_voice_profile — they train separately per surface (posts vs. comments) rather than one blended profile.

Ideas and signals

ToolWhat it does
get_ideasList content ideas, filtered by status (new, saved, used) or source (published post, saved post, Notion, Google Docs/Sheets)
generate_ideasAI-generate new ideas from your content sources (uses credits)
get_signals_inboxPull your personalized signal feed (Reddit, YouTube, RSS, trending topics)

generate_ideas consumes credits from your Reepl plan. Use get_ideas first to check existing ideas before generating new ones.

Other

ToolWhat it does
submit_feedbackSend a bug report or feature request to Reepl

MCP prompt

PromptWhat it does
carousel_guidelinesProvides carousel content and styling rules to the AI client

Use carousel_guidelines at the start of a carousel generation session to ensure the AI produces slide content that fits Reepl's carousel format.

Example prompts by category

Drafts and publishing

  • "Save a draft about the three things I wish I knew before raising a seed round."
  • "Schedule my most recent draft for Monday at 9 AM London time."
  • "Publish a post about our product launch right now."

Carousels

  • "Generate a 7-slide carousel about cold email mistakes and save it as a draft."
  • "Update my carousel draft [ID] — change the theme to bold-text."

Twitter / X

  • "Write a thread about why most startups fail at distribution and schedule it for tomorrow at 10 AM."
  • "Create a poll tweet asking my audience what content format they prefer."

Analytics

  • "What were my top 5 LinkedIn posts by engagement last month?"
  • "Show me my Twitter analytics for the past two weeks."

Ideas and signals

  • "Pull my signals inbox and suggest three post ideas based on trending topics."
  • "List my saved content ideas and turn the top one into a draft."

Contacts

  • "Find all contacts tagged as investor in my Reepl lists."
  • "Add Jane Smith to my Prospects list."

Workspace and team

  • "List all the workspaces I'm a member of and switch me to the Acme Corp one."
  • "Show me the whole team's scheduled post queue for next week."
  • "What does our workspace's brand context say about our tone of voice?"

Troubleshooting