One URL gives Claude, ChatGPT, Cursor, Codex or your own agent 76 tools to publish, schedule, design and report across 13 networks.
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}
Your AI says hello and names the version of MCP it speaks.
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","serverInfo":{"name":"robinreach","title":"RobinReach"},"capabilities":{"tools":{}},"instructions":"RobinReach is a social media scheduling tool..."}}
RobinReach agrees on the version and sends notes on how to use its tools, plus your brand's voice settings.
{"jsonrpc":"2.0","id":2,"method":"tools/list"}
It asks what it can do.
{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"account_status"},{"name":"posts_validate"},{"name":"posts_create"}, … 73 more]}}
It gets 76 tools back, each with a description and the inputs it needs.
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"posts_validate","arguments":{"social_profile_ids":[41,57],"content":"Speckled mugs are back on Friday."}}}
Before saving anything, it checks the post for Instagram and LinkedIn.
{"status":"success","message":"All validation checks passed. Ready to create."}
RobinReach confirms the post passes every network's rules.
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"posts_create","arguments":{"social_profile_ids":[41,57],"content":"Speckled mugs are back on Friday.","post_status":"scheduled","publish_time":"2026-10-16T09:00","timezone":"America/New_York"}}}
It schedules the post for Friday at 9:00, New York time.
{"success":true,"post_id":18342,"status":"scheduled","platforms":["instagram","linkedin"],"message":"Post scheduled for October 16 at 9:00 AM EDT."}
The post is on the calendar for both networks.
A real exchange with example IDs. Every message is one POST to the same URL.
One endpoint, one key, plain JSON-RPC. If your tool speaks MCP over HTTP, it can talk to RobinReach.
https://robinreach.com/mcp/v1/messages
POST /mcp/v1/messages on robinreach.com. Every JSON-RPC message goes to this one URL.Authorization: Bearer, or add ?api_key= to the URL for clients that only accept a URL.GET returns 405 because the server never pushes, and OPTIONS answers CORS preflights from any origin.initialize, ping, tools/list and tools/call. Notifications get 202 Accepted.brand_id). A brand key reaches one brand and needs no brand_id.initialize returns usage notes for the model plus the brand's tone, mission, language and time zone, so posts sound right from the first call.This list is built from the same registry the server answers tools/list with, so it is always current.
Showing 76 of 76 tools
posts_validate
Posts and scheduling
Validate post content/platform_options before creating, updating, or publishing. Always call this first. Fix any returned errors and re-validate before posts_create / posts_update / posts_publish_now. Pass post_id when validating changes to an existing post so validation checks its already-attached media (e.g. an Instagram post with no new media_urls but existing images) instead of assuming no media is attached.
social_profile_ids
8 optional inputs
posts_create
Posts and scheduling
Create and schedule (or save as draft) a post across one or more social profiles. Call posts_validate first.
social_profile_ids
12 optional inputs
posts_update
Posts and scheduling
Update an existing, unpublished post. Call posts_validate first with the merged content/options. media_urls is APPEND-ONLY by default; pass replace_media: true to replace existing attachments instead of adding to them. A library url whose file is already on the post is not added again (it is listed in media_already_attached). labels is also APPEND-ONLY by default; pass replace_labels: true to replace the post's entire label set instead of merging into it.
post_id
12 optional inputs
posts_publish_now
Posts and scheduling
Confirm first
Publish a draft/scheduled/approved post immediately. Always show the content preview and get explicit user confirmation first.
post_id
1 optional input
posts_delete
Posts and scheduling
Confirm first
Permanently delete a post. Always confirm with the user first.
post_id
1 optional input
posts_delete_from_platform
Posts and scheduling
Confirm first
Delete a published post from specific social platforms (same as the dashboard's Delete from Platform). Supported: Facebook, LinkedIn, X, Threads, Telegram, Bluesky, Pinterest, YouTube, WordPress, Mastodon. Always confirm with the user first.
post_idsocial_profile_ids
1 optional input
posts_reschedule
Posts and scheduling
Change the publish_time of a scheduled post.
post_idnew_publish_time
1 optional input
posts_list
Posts and scheduling
List posts for a brand, optionally filtered by status and/or labels (matches ANY given label). Paginated, 10 per page.
posts_get_status
Posts and scheduling
Get per-platform publish status for a post, with suggested fixes for any failures.
post_id
1 optional input
posts_bulk_create
Posts and scheduling
Create up to 20 posts in one call. Each post is validated independently; partial failures are reported per-index.
posts
1 optional input
media_search
Images and media
Search the media library by filename, optionally scoped to a folder. Call media_folders first to confirm the exact folder name. Returns metadata and a URL only, NOT the image content. Call media_view before writing a caption for, or describing, any specific result; never guess content from the filename.
media_view
Images and media
The only way to actually see image content (returns downscaled base64, up to 10 at once). ALWAYS call this before writing a caption for, or describing, a specific image; never guess from a filename like 'big.jpg'.
media_folders
Images and media
List media library folders with attachment counts.
media_search_unsplash
Images and media
Search Unsplash for stock photos. Credit the photographer when used.
query
media_generate_ai_image
Images and media
Generate an AI image from a text prompt and save it to the media library. Optionally choose model: "gpt_image" (default) or "nano_banana_pro", and size (defaults to 1024x1024). Pass post_id to attach it directly to a post (add replace_media: true to replace that post's existing media instead of appending). Check quota first; fall back to media_search_unsplash if low.
image_prompt
5 optional inputs
media_upload
Images and media
Download a public file_url into the media library. Returns job_id; poll media_upload_status a few seconds later to get the final url before using it in media_urls.
file_url
3 optional inputs
media_upload_status
Images and media
Check the status of a media_upload job_id.
job_id
1 optional input
media_direct_upload_create
Images and media
Start a direct upload for a local file with no public URL yet (screenshots, videos). Returns a signed upload_url; PUT the raw file bytes there immediately (it expires in minutes), then call media_direct_upload_finalize.
content_typebyte_sizechecksum
2 optional inputs
media_direct_upload_finalize
Images and media
Finalize a direct upload after PUTting the file bytes, using the signed_id from media_direct_upload_create. Returns the permanent attachment url. Safe to retry: finalizing the same signed_id again returns the same attachment.
signed_id
2 optional inputs
media_upload_from_chat
Images and media
Upload image/video files attached directly in this chat (e.g. an image you just generated) into the RobinReach media library. Pass each file's download_url and file_id exactly as given; never ask the user for a public URL for these. Returns library URLs; use them in media_urls on posts_create / posts_update / posts_bulk_create.
media_files
2 optional inputs
analytics_get
Analytics
Get raw engagement metrics for one social profile over a date range (default: last 30 days). A Google Business Profile answers with Google's own daily numbers under business (profile views on Search and Maps, website clicks, calls, direction requests, conversations, bookings, menu clicks) and post_analytics false, since Google has no per-post numbers.
social_profile_id
4 optional inputs
analytics_top_posts
Analytics
Get the best-performing posts by engagement over a date range.
analytics_calendar
Analytics
Get the next 14 days of scheduled posts, with any gap days flagged.
analytics_performance_summary
Analytics
Compare this week's engagement and post count to last week's, with a plain-language recommendation.
analytics_post
Analytics
Get live engagement metrics for a published post, across every profile it was published to (or one specific profile if social_profile_id is given). Aggregates per-platform results. X (Twitter) numbers are not live: they are the ones RobinReach read 1, 3 and 7 days after publishing, on the Scale plan.
post_id
2 optional inputs
comments_list
Comments
List comment threads across social profiles, sorted by most recent, with unread counts. A thread is one post's comment section. Each thread has likeable (whether comments_like works on it), last_comment (the newest message, which may be the brand's own reply), and recent_comments: the newest comments from other people, up to 5, each with external_id and liked (incoming_count is the full total). Goodwill comments (thanks, hearts, emoji, congratulations) usually deserve a like rather than a reply; group them and offer to like them with comments_like.
comments_reply
Comments
Reply to a comment thread. Requires a Bloom/Thrive plan; rate-limited to 10/minute per company.
thread_idmessage
2 optional inputs
comments_like
Comments
Like a comment as the brand, given thread_id and comment_id (an external_id from the thread's recent_comments in comments_list). The right response to goodwill comments where a reply would feel overbearing. Only works on threads where likeable is true (Facebook Pages and LinkedIn today); otherwise suggest a reply. Never like complaints, criticism, spam, or anything offensive. Only comments from other people can be liked, not the brand's own replies. One-way: likes can't be undone through this tool, so confirm with the user before liking more than a few at once. Liking an already-liked comment is a safe no-op. Requires a plan that includes comment replies; rate-limited to 30/minute per company.
thread_idcomment_id
1 optional input
style_learn
Brand voice
Analyze the brand's past posts (or, for fresh accounts, brand tone) to learn tone, length, emoji/hashtag usage, and structure. Cached for a year.
style_save_feedback
Brand voice
Save a voice/style correction after the user edits or rejects generated content, e.g. "prefers shorter captions on instagram".
feedback
2 optional inputs
account_best_time
Planning
Get the next available posting slot based on the brand's preferred times/days.
account_audience_best_times
Planning
Get peak posting times per platform. Prefer this over guessing a schedule time.
account_hashtag_groups
Planning
List saved hashtag groups for a brand.
pillars_save
Planning
Save the brand's content pillar mix, e.g. 40% Educational, 30% Promotional, 30% Behind-the-scenes. Percentages must sum to ~100.
pillars
1 optional input
pillars_list
Planning
Get the saved content pillar mix. Call when planning any content calendar.
templates_save
Planning
Save reusable post content as a template. Use {placeholder} syntax for variables.
template_nametemplate_content
2 optional inputs
templates_list
Planning
List saved templates. Call before creating recurring content types.
templates_use
Planning
Fill a saved template's placeholders with values to produce ready-to-post content.
template_name
2 optional inputs
bio_page_get
Bio Page
Get the brand's Bio Page, its link in bio page: settings, public_url, whether it is published and live, every block top to bottom, post_grid_profiles (the profiles a post grid can show) and the supported embed providers. Each brand has exactly one Bio Page, created automatically on first use and free on every plan. Call this before changing the page.
bio_page_update
Bio Page
Update the Bio Page: title, bio text, slug (its address), theme color, light or dark appearance, background, profile picture, post grid columns, the social icons row, and bio_published to put it live or take it offline. Only the fields you pass change. Images must be media library urls: import them first with media_upload, media_upload_from_chat or media_direct_upload_create, or reuse a url from media_search or media_generate_ai_image. Changing bio_slug breaks the old address, so confirm with the user first. Validation errors such as a taken slug come back in errors, exactly as the dashboard shows them.
bio_blocks_create
Bio Page
Add a block at the bottom of the Bio Page: a link button, a card (product or offer with optional image, price and button), a post_grid (latest posts published through RobinReach from one profile, taken from post_grid_profiles in bio_page_get) or an embed (YouTube, Vimeo, TikTok, Spotify, SoundCloud or Apple Music player). Put the content in bio_block_settings; bio_block_image_url sets a card's image. Use bio_blocks_reorder to move it.
bio_block_typebio_block_settings
2 optional inputs
bio_blocks_update
Bio Page
Change a Bio Page block's content. Only the bio_block_settings keys you pass change ("" clears one); bio_block_image_url replaces a card's image. A block's type cannot change: add a new block and delete the old one instead.
bio_block_id
3 optional inputs
bio_blocks_delete
Bio Page
Confirm first
Permanently remove a block from the Bio Page, along with its click stats. Always confirm with the user first.
bio_block_id
1 optional input
bio_blocks_reorder
Bio Page
Set the order of the Bio Page blocks. Pass bio_block_ids top to bottom. Blocks you leave out keep their current order below the ones you list, so passing one id moves that block to the top.
bio_block_ids
1 optional input
bio_page_analytics
Bio Page
Bio Page stats, the same figures as the dashboard's Bio Page analytics: views, clicks and click-through rate on every plan; on paid plans also unique visitors, bounce rate, a daily views and clicks trend for the last 30 days, the most clicked blocks, traffic sources, countries and devices. Bot traffic is excluded. Use it to answer how the link in bio page is doing or which link gets the most clicks.
comment_automations_list
Comment to DM
List Comment to DM automations for a brand, with available social profiles (Facebook Pages and Instagram professional accounts only) and remaining plan quota. Call this before offering to create one: check can_use_comment_automation and comment_automations_remaining, and take social_profile_id from available_social_profiles.
comment_automations_create
Comment to DM
Create a Comment to DM automation: whenever someone comments a trigger keyword on the given social profile's posts, they get an automatic private DM. Only facebook and instagram_direct profiles are supported; call comment_automations_list first to get a valid social_profile_id and check plan quota. The profile is fixed for the life of the automation (create a new one to target another page/account). Keywords match case-insensitively: single words with light stemming, multi-word phrases as an exact substring. Each person is only ever DM'd once per automation, even if they comment a keyword again later: deliberate spam prevention, not a bug. Instagram automations currently fire reliably only on posts published through RobinReach; comments on posts published natively in the Instagram app may not trigger yet. comment_automation_send_public_reply requires comment_automation_public_reply_message.
social_profile_idcomment_automation_namecomment_automation_keywordscomment_automation_dm_message
3 optional inputs
comment_automations_update
Comment to DM
Update an existing Comment to DM automation's name, keywords, message, or public reply settings. The social profile it's attached to cannot be changed; create a new automation instead.
comment_automation_id
7 optional inputs
comment_automations_delete
Comment to DM
Confirm first
Permanently delete a Comment to DM automation. Always confirm with the user first.
comment_automation_id
1 optional input
comment_automations_toggle_active
Comment to DM
Pause or resume a Comment to DM automation without changing its settings.
comment_automation_id
1 optional input
rss_list
RSS feeds
List all RSS feeds for the brand.
rss_validate
RSS feeds
Validate RSS feed parameters. Always call before rss_create or rss_update; never call those without a preceding successful rss_validate.
rss_create
RSS feeds
Create an RSS feed. Call rss_validate first. rss_publish_immediately and rss_auto_schedule are mutually exclusive.
rss_feed_namerss_feed_url
13 optional inputs
rss_update
RSS feeds
Update an existing RSS feed. Call rss_validate first.
rss_feed_id
15 optional inputs
rss_delete
RSS feeds
Confirm first
Permanently delete an RSS feed (does not delete posts it already created). Always confirm with the user first.
rss_feed_id
1 optional input
rss_toggle_pause
RSS feeds
Pause or resume an RSS feed.
rss_feed_id
1 optional input
rss_sync
RSS feeds
Manually trigger an RSS feed sync now.
rss_feed_id
1 optional input
repurposing_list
Repurpose and import
List repurposing tasks and the available_source_profiles, the only profiles valid as a source. Any connected profile can be a destination.
repurposing_create
Repurpose and import
Create a task that repurposes content from one source profile to one or more destination profiles. Call repurposing_list first; only offer source profiles from its available_source_profiles list.
source_profile_iddestination_profile_ids
6 optional inputs
repurposing_update
Repurpose and import
Update a repurposing task's source, destinations, or settings.
repurposing_task_id
8 optional inputs
repurposing_delete
Repurpose and import
Confirm first
Permanently delete a repurposing task. Always confirm with the user first.
repurposing_task_id
1 optional input
repurposing_toggle_pause
Repurpose and import
Pause or resume a repurposing task.
repurposing_task_id
1 optional input
repurposing_run
Repurpose and import
Run a repurposing task now. Returns how many posts it created, or why nothing could be fetched from the source (for example an expired connection).
repurposing_task_id
1 optional input
content_article_to_posts
Repurpose and import
Convert an article URL into draft posts, optionally tagged with custom hashtags.
article_url
4 optional inputs
store_sync_products
Repurpose and import
Sync products from a connected Shopify/Etsy/WooCommerce store into new draft posts. Pass store_type: "auto" to detect automatically.
connect_links_list
Client links
List Connect Links for this brand: client-facing onboarding links that let a client connect their own social profiles without an account.
connect_links_create
Client links
Confirm first
Create a Connect Link and return its one-time plaintext URL. Gated by the brand's plan limit. Confirm with the user first; the URL is shown only once and cannot be retrieved again through this tool.
link_title
3 optional inputs
approval_links_list
Client links
List Approval Links for this brand: client-facing links that let a client review and approve/reject pending posts without an account. Only available on Thrive and Scale plans.
approval_links_create
Client links
Confirm first
Create an Approval Link and return its one-time plaintext URL. Only available on Thrive and Scale plans. Confirm with the user first; the URL is shown only once and cannot be retrieved again through this tool.
link_title
4 optional inputs
account_status
Account and networks
Get plan limits/usage, brand settings, connected profiles, voice preferences, and writing style. Call once at the start of a session.
account_brands
Account and networks
List every brand on this account with profile/post counts. Use when the account has multiple brands and you need to ask the user which to work in.
account_profiles
Account and networks
List connected social profiles for a brand, with per-platform character limits.
pinterest_list_boards
Account and networks
List Pinterest boards for a connected profile.
youtube_list_playlists
Account and networks
List YouTube playlists for a connected profile.
wordpress_list_categories
Account and networks
List WordPress categories. Never guess category IDs; call this first.
wordpress_list_tags
Account and networks
List WordPress tags. Never guess tag IDs; call this first.
No tool matches that search.
Names and descriptions are shown exactly as the server sends them, in English.
Most failed AI posts come from guessing. The server is built to take the guessing out.
posts_validate checks content, media and every network's limits. posts_create runs the same checks again on the server, so a skipped step cannot slip through.
Boards, playlists, WordPress categories and tags come from list tools, and the instructions tell the model never to guess one.
posts_bulk_create takes up to 20 posts. Each is validated on its own and failures come back by index, so one bad post never sinks the rest.
Public URLs, files attached in the chat, and signed direct uploads for local files. media_view lets the model see up to 10 images before it writes about them.
Every JSON-RPC error echoes the request id, tool failures come back with isError, and unexpected ones carry a request id you can quote to support.
9 tools publish right away, delete for good or return a link shown only once. Their descriptions and the server instructions tell the model to confirm with the person first.
Snippets for the most common clients. Your dashboard has the same ones with your key already in place.
claude mcp add --transport http robinreach "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
Adds RobinReach to Claude Code over HTTP. Run claude mcp list to check it.
codex mcp add robinreach -- npx -y mcp-remote "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
Codex connects through the mcp-remote bridge, which needs Node.js.
gemini mcp add --transport http robinreach "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
Adds RobinReach to Gemini CLI over HTTP.
{
"mcpServers": {
"robinreach": {
"url": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
Open Cursor Settings, then MCP & Integrations, then New MCP Server, and add this block.
{
"servers": {
"robinreach": {
"type": "http",
"url": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
Save this in your workspace, or run MCP: Add Server from the Command Palette and choose HTTP. Use it with Copilot Chat in Agent mode.
{
"mcpServers": {
"robinreach": {
"serverUrl": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
In Windsurf open Settings, then Cascade, then Manage MCPs and View raw config.
{
"mcpServers": {
"robinreach": {
"command": "npx",
"args": ["mcp-remote", "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"]
}
}
}
In Claude Desktop open Settings, then Developer, then Edit Config. It uses the mcp-remote bridge, so Node.js must be installed. On claude.ai you can paste the URL under Settings, Connectors instead.
import anthropic client = anthropic.Anthropic() response = client.beta.messages.create( model="claude-opus-5-5", max_tokens=16000, betas=["mcp-client-2025-11-20"], mcp_servers=[{ "type": "url", "url": "https://robinreach.com/mcp/v1/messages", "name": "robinreach", "authorization_token": "YOUR_API_KEY", }], tools=[{"type": "mcp_toolset", "mcp_server_name": "robinreach"}], messages=[{"role": "user", "content": "What is scheduled for next week?"}], )
Use RobinReach from your own code with the Claude API's MCP connector. Claude calls the tools for you, and the key travels as a Bearer token.
from openai import OpenAI client = OpenAI() response = client.responses.create( model="gpt-5", tools=[{ "type": "mcp", "server_label": "robinreach", "server_url": "https://robinreach.com/mcp/v1/messages", "headers": {"Authorization": "Bearer YOUR_API_KEY"}, }], input="What is scheduled for next week?", )
The OpenAI Responses API connects to remote MCP servers the same way. Pass the key in the Authorization header.
curl -s https://robinreach.com/mcp/v1/messages \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
The raw protocol. Swap tools/list for tools/call with a name and arguments to run a tool.
YOUR_API_KEY is a placeholder. Generate a key under Integrations in your dashboard.
The RobinReach skill gives Claude what the tools alone cannot: how each network behaves, how to plan a calendar and how to write in your voice.
curl -fsSL "https://robinreach.com/downloads/robinreach-claude-skill.zip?v=8e70fda9" -o /tmp/rr-skill.zip && mkdir -p ~/.claude/skills && unzip -oq /tmp/rr-skill.zip -d ~/.claude/skills && rm /tmp/rr-skill.zip && echo "RobinReach skill installed."
Get a key, paste the URL, and your agent can run 13 networks.
MCP access is included with Bloom, Thrive and Scale.