Reach MCP
Operate a real LinkedIn account from your AI agent.
What it can do
- Reach Playbooks: START HERE. Return the catalogue of ready-made LinkedIn playbooks — what this server can actually accomplish, as named workflows rather than raw endpoints. Each entry carries its tool
- List Accounts: Return LinkedIn accounts accessible with the provided API key. If the key is restricted, only allowed account IDs are returned.
- Delete Account: Delete a LinkedIn account by account_id. Also clears invitation references before deletion.
What data it sees
Do you need an account
No: the server works without sign-in
Operate a real LinkedIn account from your AI agent. 52 tools for the inbox, invitations, network, profiles, Sales Navigator search in plain language, posts and engagement; six playbooks served as MCP prompts that preview before they write; daily quotas enforced server-side; structured errors; idempotent writes; signed webhooks when a prospect replies or a connection is accepted. LinkedIn only. 7-day trial, no card.
How to connect
How to connect Reach MCP to Claude
The server address to paste into Claude settings:
https://reachmcp--jean-iudk.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect Reach MCP to ChatGPT
The server address to paste into ChatGPT settings:
https://reachmcp--jean-iudk.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect Reach MCP to Cursor
The server address to paste into Cursor settings:
https://reachmcp--jean-iudk.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (52)
Raw names from tools/list. Only developers need these.
| reach_playbooks | START HERE. Return the catalogue of ready-made LinkedIn playbooks — what this server can actually accomplish, as named workflows rather than raw endpoints. Each entry carries its tool sequence, its prerequisites, and the full instructions to run it. Call this first when the user asks what you can do with their LinkedIn account, or when a request is vague. Pass playbook_id to get one playbook's instructions and then follow them. |
| list_accounts | Return LinkedIn accounts accessible with the provided API key. If the key is restricted, only allowed account IDs are returned. |
| delete_account | Delete a LinkedIn account by account_id. Also clears invitation references before deletion. |
| get_account_quotas | Get the quotas configuration and usage counters for a LinkedIn account. |
| update_account_quotas | Update one or more quota configuration fields for a LinkedIn account. Only provided fields are updated. |
| get_account_request_logs | Get request logs for a LinkedIn account with optional filtering by request_type and pagination using limit/offset. |
| get_account_request_logs_stats | Get aggregated request-log statistics for a LinkedIn account, grouped by day, week, or month, with optional action and date-range filters. |
| get_me | Call LinkedIn Voyager /me for an account through the stored proxy/cookies and return the normalized profile (same fields as Kanbox uses from /me). |
| list_connections | List LinkedIn 1st-degree connections for an account (Voyager dash connections), paged with start/count — same payload as GET /api/linkedin/{account_id}/connections. |
| list_conversations | List LinkedIn messenger conversations (Voyager Messaging GraphQL), with optional archived, unread, starred filters and next_cursor paging — same as GET /api/linkedin/{account_id}/conversations. Each item returns conversation_id (the thread id — use this as conversation_linkedin_id when fetching messages or replying) and recipient_linkedin_id (the peer's fsd_profile id — use this as recipient_linkedin_id when sending a new message). |
| list_conversation_messages | List messages in a LinkedIn conversation via Voyager ``/messaging/conversations/{id}/events`` (Kanbox ``get_conversation_messages``), with optional created_before paging — same as GET /api/linkedin/{account_id}/conversations/{conversation_linkedin_id}/messages. |
| list_scheduled_posts | List scheduled LinkedIn posts for an account, paged. Returns post URNs, text content, and scheduled publish times. |
| update_scheduled_post | Update the text and/or scheduled time of an existing scheduled LinkedIn post. post_urn is the URN returned by list_scheduled_posts (e.g. urn:li:ugcPost:…). At least one of text or scheduled_at must be provided. |
| delete_scheduled_post | Delete a scheduled LinkedIn post. post_urn is the URN returned by list_scheduled_posts (e.g. urn:li:ugcPost:…). |
| upload_media_from_url | Upload an image to LinkedIn by fetching it from a public URL. Returns a digitalmediaAsset URN (urn:li:digitalmediaAsset:…) that can be passed to create_post (single image) or create_multi_photo (multi-photo). Use this instead of upload-media when working as an agent — no binary file upload needed. |
| create_multi_photo | Create a LinkedIn multi-photo object from a list of digitalmediaAsset URNs. Returns an identifierUrn (urn:li:fsd_multiPhoto:…) to pass to create_post. author_urn is the urn:li:fsd_profile:… of the connected account (get it from get_me). |
| create_post | Create or schedule a LinkedIn post, optionally with a media attachment. For a single image pass a urn:li:digitalmediaAsset:… URN; for multiple images pass a urn:li:fsd_multiPhoto:… URN from create_multi_photo. Set scheduled_at (Unix ms) to schedule; omit it to publish immediately. |
| send_message | Send a LinkedIn DM via Voyager createMessage: use conversation_linkedin_id for an existing thread or recipient_linkedin_id for a new DM. |
| scrape_profile | Fetch a complete LinkedIn profile (name, headline, company, experience, skills…). Pass a LinkedIn URL, vanity name, internal member ID, or Sales Navigator lead URL. Uses SalesNav API when available for richer data. |
| scrape_search | Run one page of a LinkedIn, Sales Navigator, or Recruiter search and return normalized profile rows. Pass the full search URL. Use start+count to paginate (count ignored for standard LinkedIn, fixed ~10/page). |
| visit_profile | Simulate a profile view, triggering a 'viewed your profile' notification for the target member. |
| profile_viewers | Get the list of members who recently viewed the account's profile (requires LinkedIn Premium). |
| user_posts | Get recent posts published by a LinkedIn member (via profileUpdatesV2). Paginate with start/count. |
| scrape_post | Fetch likers and/or commenters for a LinkedIn post. Pass the full post URL or slug. Set liked=true and/or comments=true. |
| scrape_my_posts | Fetch likers and/or commenters for the account's own recent posts. since_hours limits to posts published in the last N hours (default 24). |
| like_post | Like a LinkedIn post on behalf of the connected account. Pass the post URL, slug, or URN. |
| comment_post | Post a comment on a LinkedIn post on behalf of the connected account. |
| reply_comment | Post a reply to an existing LinkedIn comment. Pass the comment_id (URN) returned by scrape_post as comment_urn — it is used directly as threadUrn. |
| star_conversation | Star or unstar a LinkedIn conversation. Set star=false to remove the star. conversation_linkedin_id is the conversation_id returned by list_conversations. |
| archive_conversation | Archive or unarchive a LinkedIn conversation. Set archive=false to unarchive. conversation_linkedin_id is the conversation_id returned by list_conversations. |
| delete_conversation | Permanently delete a LinkedIn conversation. conversation_linkedin_id is the conversation_id returned by list_conversations. |
| react_message | Add or remove an emoji reaction on a LinkedIn message. Set react=false to remove the reaction. message_urn is the message_urn returned by list_conversation_messages (e.g. urn:li:msg_message:(urn:li:fsd_profile:…,123456789)). emoji is a Unicode emoji character (e.g. 👍, ❤️). Pass conversation_linkedin_id to also mark the conversation as read. |
| connect | Send a connection request to a LinkedIn member. Optional message capped at 300 chars (premium) or 200 chars. |
| invitation_status | Get the connection and invitation status between the connected account and a LinkedIn member. Returns is_connection, invitation_type (SENT/PENDING/WITHDRAWN/REFUSED). |
| withdraw_invitation | Withdraw a pending sent connection request. |
| accept_invitation | Accept a pending received connection request. |
| decline_invitation | Decline/ignore a pending received connection request. |
| remove_connection | Remove an existing 1st-degree connection. |
| follow | Follow or unfollow a LinkedIn member without connecting. Set follow=false to unfollow. |
| list_received_invitations | List pending connection invitations received by the account (with invitation_secret to accept them). |
| list_sent_invitations | List pending connection invitations sent by the account that have not yet been accepted. |
| salesnav_list_thread_messages | Fetch a Sales Navigator thread with all its messages and participant profiles (salesApiMessagingThreads/{id}). Requires a Sales Navigator subscription. Use the thread id returned by salesnav_list_messaging_threads. message_count controls how many (most recent) messages are returned; compare with total_message_count in the response to know if more exist. |
| salesnav_send_message | Send a message in an existing Sales Navigator thread (salesApiMessageActions). Requires the account to have a Sales Navigator subscription. Use the thread id returned by salesnav_list_messaging_threads. |
| salesnav_list_messaging_threads | List Sales Navigator messaging threads (salesApiMessagingThreads). Requires the account to have a Sales Navigator subscription (has_sales_nav). Returns threads with messages and participant profiles. Paginate by passing next_page_starts_at from the previous response as page_starts_at. |
| salesnav_resolve_industry | Resolve an industry name (any language) to its LinkedIn Industry Code(s) using the bundled Industry Codes V2 taxonomy (offline, no LinkedIn call). Returns ranked candidates with id, label and hierarchy path. Use the returned id(s) in salesnav_build_search_url's `industry` filter. Call once per industry term; if several candidates look plausible, pick by the hierarchy path. |
| salesnav_typeahead | Live Sales Navigator autocomplete for facets whose ids are dynamic. Use type='geo' to resolve a location to its REGION id (the only reliable way — LinkedIn region ids are not enumerable), and type='company' / 'school' / 'title' for those entity facets. Returns [{id, displayValue, headline}]. Feed the chosen id into salesnav_build_search_url (region / current_company / school / current_title). Requires a connected account. |
| salesnav_build_search_url | Build a Sales Navigator people-search URL from structured lead-search filters, using as many filters as the request implies. RESOLUTION: `industry` accepts numeric ids OR names (auto-resolved via the taxonomy); `region` accepts numeric REGION ids OR location names (auto-resolved via geo typeahead — needs account_id). If a name is ambiguous, the tool returns {needs_disambiguation:[...]} with candidates instead of a URL — re-call with the chosen id. BOOLEAN: `keywords` and `current_title` accept LinkedIn boolean syntax (AND/OR/NOT, quotes, parentheses). EXCLUSION: any list value may be an object {id|name, exclude:true}. Set execute=true to also run the first page of results (reuses the live search) and return leads. |
| list_webhook_endpoints | List the webhooks registered for this user: the URLs Reach calls when a conversation gets a new message (message.received), the account gains a 1st-degree connection (connection.new), an account changes connection state (account.status_changed) or a daily quota is close to or at its limit (quota.threshold_reached, quota.reached). Read-only. |
| create_webhook_endpoint | Register a URL to be called when something happens on LinkedIn, so an agent or an n8n/Make workflow can react instead of polling. Returns the signing secret ONCE; deliveries carry 'Reach-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, t + '.' + body)>'. Events: message.received, connection.new, account.status_changed, quota.threshold_reached, quota.reached, or '*' for all. Omit account_ids to subscribe for every account of the user. https only. |
| update_webhook_endpoint | Change a webhook's url, events, account_ids, description or is_active. Only provided fields change. Re-enabling clears the failure counter. |
| delete_webhook_endpoint | Delete a webhook endpoint and its delivery history. |
| test_webhook_endpoint | Send a signed 'ping' event to a webhook endpoint right now and report the HTTP status it answered. |