Uma URL dá ao Claude, ao ChatGPT, ao Cursor, ao Codex ou ao seu próprio agente 76 ferramentas para publicar, agendar, criar e analisar em 13 redes.
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}
Sua IA diz oi e informa a versão do MCP que fala.
{"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..."}}
O RobinReach aceita a versão e envia notas sobre como usar as ferramentas, além das configurações de voz da sua marca.
{"jsonrpc":"2.0","id":2,"method":"tools/list"}
Ela pergunta o que pode fazer.
{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"account_status"},{"name":"posts_validate"},{"name":"posts_create"}, … 73 more]}}
Recebe 76 ferramentas, cada uma com uma descrição e os dados de que precisa.
{"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."}}}
Antes de salvar qualquer coisa, ela confere o post para o Instagram e o LinkedIn.
{"status":"success","message":"All validation checks passed. Ready to create."}
O RobinReach confirma que o post segue as regras de cada rede.
{"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"}}}
Ela agenda o post para sexta às 9h, horário de Nova York.
{"success":true,"post_id":18342,"status":"scheduled","platforms":["instagram","linkedin"],"message":"Post scheduled for October 16 at 9:00 AM EDT."}
O post está no calendário das duas redes.
Uma troca real com IDs de exemplo. Cada mensagem é um POST para a mesma URL.
Um endpoint, uma chave, JSON-RPC simples. Se a sua ferramenta fala MCP por HTTP, ela fala com o RobinReach.
https://robinreach.com/mcp/v1/messages
POST /mcp/v1/messages em robinreach.com. Toda mensagem JSON-RPC vai para essa única URL.Authorization: Bearer, ou adicione ?api_key= à URL para clientes que só aceitam uma URL.GET retorna 405 porque o servidor nunca envia nada por conta própria, e OPTIONS responde a preflights de CORS de qualquer origem.initialize, ping, tools/list e tools/call. Notificações recebem 202 Accepted.brand_id). Uma chave de marca alcança uma só marca e não precisa de brand_id.initialize devolve notas de uso para o modelo, além do tom, da missão, do idioma e do fuso horário da marca, para que os posts soem certos desde a primeira chamada.Esta lista é gerada a partir do mesmo registro que o servidor usa para responder ao tools/list, então está sempre atualizada.
Mostrando 76 de 76 ferramentas
posts_validate
Posts e agendamento
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 parâmetros opcionais
posts_create
Posts e agendamento
Create and schedule (or save as draft) a post across one or more social profiles. Call posts_validate first.
social_profile_ids
12 parâmetros opcionais
posts_update
Posts e agendamento
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 parâmetros opcionais
posts_publish_now
Posts e agendamento
Confirmar antes
Publish a draft/scheduled/approved post immediately. Always show the content preview and get explicit user confirmation first.
post_id
1 parâmetro opcional
posts_delete
Posts e agendamento
Confirmar antes
Permanently delete a post. Always confirm with the user first.
post_id
1 parâmetro opcional
posts_delete_from_platform
Posts e agendamento
Confirmar antes
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 parâmetro opcional
posts_reschedule
Posts e agendamento
Change the publish_time of a scheduled post.
post_idnew_publish_time
1 parâmetro opcional
posts_list
Posts e agendamento
List posts for a brand, optionally filtered by status and/or labels (matches ANY given label). Paginated, 10 per page.
posts_get_status
Posts e agendamento
Get per-platform publish status for a post, with suggested fixes for any failures.
post_id
1 parâmetro opcional
posts_bulk_create
Posts e agendamento
Create up to 20 posts in one call. Each post is validated independently; partial failures are reported per-index.
posts
1 parâmetro opcional
media_search
Imagens e mídia
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
Imagens e mídia
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
Imagens e mídia
List media library folders with attachment counts.
media_search_unsplash
Imagens e mídia
Search Unsplash for stock photos. Credit the photographer when used.
query
media_generate_ai_image
Imagens e mídia
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 parâmetros opcionais
media_upload
Imagens e mídia
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 parâmetros opcionais
media_upload_status
Imagens e mídia
Check the status of a media_upload job_id.
job_id
1 parâmetro opcional
media_direct_upload_create
Imagens e mídia
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 parâmetros opcionais
media_direct_upload_finalize
Imagens e mídia
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 parâmetros opcionais
media_upload_from_chat
Imagens e mídia
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 parâmetros opcionais
analytics_get
Análises
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 parâmetros opcionais
analytics_top_posts
Análises
Get the best-performing posts by engagement over a date range.
analytics_calendar
Análises
Get the next 14 days of scheduled posts, with any gap days flagged.
analytics_performance_summary
Análises
Compare this week's engagement and post count to last week's, with a plain-language recommendation.
analytics_post
Análises
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 parâmetros opcionais
comments_list
Comentários
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
Comentários
Reply to a comment thread. Requires a Bloom/Thrive plan; rate-limited to 10/minute per company.
thread_idmessage
2 parâmetros opcionais
comments_like
Comentários
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 parâmetro opcional
style_learn
Voz da marca
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
Voz da marca
Save a voice/style correction after the user edits or rejects generated content, e.g. "prefers shorter captions on instagram".
feedback
2 parâmetros opcionais
account_best_time
Planejamento
Get the next available posting slot based on the brand's preferred times/days.
account_audience_best_times
Planejamento
Get peak posting times per platform. Prefer this over guessing a schedule time.
account_hashtag_groups
Planejamento
List saved hashtag groups for a brand.
pillars_save
Planejamento
Save the brand's content pillar mix, e.g. 40% Educational, 30% Promotional, 30% Behind-the-scenes. Percentages must sum to ~100.
pillars
1 parâmetro opcional
pillars_list
Planejamento
Get the saved content pillar mix. Call when planning any content calendar.
templates_save
Planejamento
Save reusable post content as a template. Use {placeholder} syntax for variables.
template_nametemplate_content
2 parâmetros opcionais
templates_list
Planejamento
List saved templates. Call before creating recurring content types.
templates_use
Planejamento
Fill a saved template's placeholders with values to produce ready-to-post content.
template_name
2 parâmetros opcionais
bio_page_get
Página bio
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
Página bio
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
Página bio
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 parâmetros opcionais
bio_blocks_update
Página bio
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 parâmetros opcionais
bio_blocks_delete
Página bio
Confirmar antes
Permanently remove a block from the Bio Page, along with its click stats. Always confirm with the user first.
bio_block_id
1 parâmetro opcional
bio_blocks_reorder
Página bio
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 parâmetro opcional
bio_page_analytics
Página bio
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
Comentário para 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
Comentário para 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 parâmetros opcionais
comment_automations_update
Comentário para 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 parâmetros opcionais
comment_automations_delete
Comentário para DM
Confirmar antes
Permanently delete a Comment to DM automation. Always confirm with the user first.
comment_automation_id
1 parâmetro opcional
comment_automations_toggle_active
Comentário para DM
Pause or resume a Comment to DM automation without changing its settings.
comment_automation_id
1 parâmetro opcional
rss_list
Feeds RSS
List all RSS feeds for the brand.
rss_validate
Feeds RSS
Validate RSS feed parameters. Always call before rss_create or rss_update; never call those without a preceding successful rss_validate.
rss_create
Feeds RSS
Create an RSS feed. Call rss_validate first. rss_publish_immediately and rss_auto_schedule are mutually exclusive.
rss_feed_namerss_feed_url
13 parâmetros opcionais
rss_update
Feeds RSS
Update an existing RSS feed. Call rss_validate first.
rss_feed_id
15 parâmetros opcionais
rss_delete
Feeds RSS
Confirmar antes
Permanently delete an RSS feed (does not delete posts it already created). Always confirm with the user first.
rss_feed_id
1 parâmetro opcional
rss_toggle_pause
Feeds RSS
Pause or resume an RSS feed.
rss_feed_id
1 parâmetro opcional
rss_sync
Feeds RSS
Manually trigger an RSS feed sync now.
rss_feed_id
1 parâmetro opcional
repurposing_list
Reaproveitar e importar
List repurposing tasks and the available_source_profiles, the only profiles valid as a source. Any connected profile can be a destination.
repurposing_create
Reaproveitar e importar
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 parâmetros opcionais
repurposing_update
Reaproveitar e importar
Update a repurposing task's source, destinations, or settings.
repurposing_task_id
8 parâmetros opcionais
repurposing_delete
Reaproveitar e importar
Confirmar antes
Permanently delete a repurposing task. Always confirm with the user first.
repurposing_task_id
1 parâmetro opcional
repurposing_toggle_pause
Reaproveitar e importar
Pause or resume a repurposing task.
repurposing_task_id
1 parâmetro opcional
repurposing_run
Reaproveitar e importar
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 parâmetro opcional
content_article_to_posts
Reaproveitar e importar
Convert an article URL into draft posts, optionally tagged with custom hashtags.
article_url
4 parâmetros opcionais
store_sync_products
Reaproveitar e importar
Sync products from a connected Shopify/Etsy/WooCommerce store into new draft posts. Pass store_type: "auto" to detect automatically.
connect_links_list
Links para clientes
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
Links para clientes
Confirmar antes
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 parâmetros opcionais
approval_links_list
Links para clientes
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
Links para clientes
Confirmar antes
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 parâmetros opcionais
account_status
Conta e redes
Get plan limits/usage, brand settings, connected profiles, voice preferences, and writing style. Call once at the start of a session.
account_brands
Conta e redes
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
Conta e redes
List connected social profiles for a brand, with per-platform character limits.
pinterest_list_boards
Conta e redes
List Pinterest boards for a connected profile.
youtube_list_playlists
Conta e redes
List YouTube playlists for a connected profile.
wordpress_list_categories
Conta e redes
List WordPress categories. Never guess category IDs; call this first.
wordpress_list_tags
Conta e redes
List WordPress tags. Never guess tag IDs; call this first.
Nenhuma ferramenta corresponde a essa busca.
Os nomes e as descrições aparecem exatamente como o servidor envia, em inglês.
A maioria dos posts de IA que dão errado vem de chutes. O servidor foi feito para acabar com os chutes.
posts_validate confere o conteúdo, a mídia e os limites de cada rede. posts_create repete as mesmas verificações no servidor, então um passo pulado não passa.
Pastas, playlists, categorias e tags do WordPress vêm de ferramentas de listagem, e as instruções dizem ao modelo para nunca chutar um ID.
posts_bulk_create aceita até 20 posts. Cada um é validado separadamente e as falhas voltam com o índice, então um post ruim nunca derruba os outros.
URLs públicas, arquivos anexados no chat e uploads diretos assinados para arquivos locais. media_view permite ao modelo ver até 10 imagens antes de escrever sobre elas.
Todo erro JSON-RPC devolve o id da requisição, falhas de ferramenta vêm com isError e as inesperadas trazem um id de requisição para você passar ao suporte.
9 ferramentas publicam na hora, apagam para sempre ou devolvem um link mostrado uma única vez. As descrições delas e as instruções do servidor dizem ao modelo para confirmar antes com a pessoa.
Trechos para os clientes mais comuns. Seu painel tem os mesmos com a sua chave já colocada.
claude mcp add --transport http robinreach "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
Adiciona o RobinReach ao Claude Code por HTTP. Rode claude mcp list para conferir.
codex mcp add robinreach -- npx -y mcp-remote "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
O Codex se conecta pela ponte mcp-remote, que precisa do Node.js.
gemini mcp add --transport http robinreach "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
Adiciona o RobinReach ao Gemini CLI por HTTP.
{
"mcpServers": {
"robinreach": {
"url": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
Abra Cursor Settings, depois MCP & Integrations, depois New MCP Server, e adicione este bloco.
{
"servers": {
"robinreach": {
"type": "http",
"url": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
Salve isto no seu workspace, ou rode MCP: Add Server na paleta de comandos e escolha HTTP. Use com o Copilot Chat no modo Agent.
{
"mcpServers": {
"robinreach": {
"serverUrl": "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
}
}
}
No Windsurf, abra Settings, depois Cascade, depois Manage MCPs e View raw config.
{
"mcpServers": {
"robinreach": {
"command": "npx",
"args": ["mcp-remote", "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"]
}
}
}
No Claude Desktop, abra Settings, depois Developer, depois Edit Config. Usa a ponte mcp-remote, então o Node.js precisa estar instalado. No claude.ai você também pode colar a URL em Settings, Connectors.
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 o RobinReach no seu próprio código com o conector MCP da Claude API. O Claude chama as ferramentas por você, e a chave vai como token Bearer.
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?", )
A OpenAI Responses API se conecta a servidores MCP remotos do mesmo jeito. Passe a chave no cabeçalho Authorization.
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"}'
O protocolo puro. Troque tools/list por tools/call com um name e arguments para rodar uma ferramenta.
YOUR_API_KEY é um espaço reservado. Gere uma chave em Integrações, no seu painel.
A skill do RobinReach dá ao Claude o que as ferramentas sozinhas não dão: como cada rede funciona, como planejar um calendário e como escrever com a sua voz.
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."
Pegue uma chave, cole a URL e seu agente passa a cuidar de 13 redes.
O acesso MCP está incluído nos planos Bloom, Thrive e Scale.