Linked API

io.github.Linked-API/linkedapi-mcp · v2.3.21 · marketing-and-seo

Linked API is healthy: it completed an MCP handshake in 847 ms and exposes 68 tools.

Manage LinkedIn messages, connections, posts, and profile data through Linked API.

Endpoint: https://mcp.linkedapi.io/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count68
Latency847 ms
Last checked (UTC)2026-10-29T19:05:21.695Z

Health history

Checked (UTC)StatusLatencyError
2026-10-29T19:05:21.695ZHealthy847

Tools (68)

send_messageAllows you to send a message to a person (st.sendMessage action). Provide either personUrl or threadId (threadId replies into an existing conversation thread and takes precedence). Optionally pass manageConversation to archive, star, or mute the conversation right after the message is sent (chained
sync_inboxRecommended first step before reading messages. Enable whole-inbox monitoring so every incoming conversation can be polled with get_inbox (st.syncInbox action). Run once per account, before sending messages whose replies you want to read; only messages that arrive after it is enabled are captured.
get_inboxDefault way to read LinkedIn messages (standard and Sales Navigator), newest first. Without personUrl returns new messages across all conversations since inbox monitoring was enabled; requires sync_inbox (or nv_sync_inbox) once per account. With personUrl returns the whole known conversation with th
sync_conversationLoads this person's earlier message history (st.syncConversation action). Call once per person; repeating it within 24 hours returns quickly. Do not call it to check for new messages – use get_inbox. After it completes, read the history with get_inbox and personUrl. Linked API actions are queued in
get_conversationLegacy. Prefer get_inbox with personUrl. Retrieve a conversation with a LinkedIn person via standard LinkedIn messaging. Returns the conversation immediately if it has already been synced. If the conversation has not been synced yet, this tool starts a syncConversation workflow and returns its ack (
sync_networkEnable background network monitoring so connection events can be polled with get_network (st.syncNetwork action). Run once per account; only changes that happen after it is enabled are captured. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server ret
get_networkGet connection events from the monitored network, newest first. Requires network monitoring to be enabled once with sync_network. Event types: "connectionAccepted" (a connection request you sent was accepted), "connectionAdded" (a new connection appeared in your network), "connectionRequestReceived"
manage_conversationArchive, star, or mute a conversation thread by threadId (st.manageConversation action). Provide the threadId as returned by get_inbox and the operation to perform. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after startin
check_connection_statusAllows you to check the connection status between your account and another person (st.checkConnectionStatus action). Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after starting the workflow with {status: 'pending'|'running'
retrieve_connectionsallows you to retrieve your connections and perform additional person-related actions if needed (st.retrieveConnections action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. Linked API actions are queued
send_connection_requestAllows you to send a connection request to a person (st.sendConnectionRequest action). If this workflow is still running, do not retry this tool; retrying can queue duplicate connection request attempts for the same person. Linked API actions are queued into a cloud-browser workflow and may take se
withdraw_connection_requestAllows you to withdraw the connection request sent to a person (st.withdrawConnectionRequest action). If this workflow is still running, do not retry this tool; retrying can queue duplicate withdrawal attempts for the same person. Linked API actions are queued into a cloud-browser workflow and may
retrieve_pending_requestsAllows you to retrieve pending connection requests sent from your account. (st.retrievePendingRequests action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. Linked API actions are queued into a cloud-bro
retrieve_invitationsRetrieves incoming connection, company-follow, and newsletter-subscription invitations received by your account (st.retrieveInvitations action). Every invitation carries urn — the permanent LinkedIn member URN (urn:li:member:<id>) of the person who sent it, or null when LinkedIn does not expose it.
accept_invitationAccepts an incoming connection, company-follow, or newsletter-subscription invitation (st.acceptInvitation action). Set invitationType and provide only its matching URL. If this workflow is still running, do not retry this tool; retrying can queue duplicate accept attempts. Linked API actions are q
ignore_invitationIgnores an incoming connection, company-follow, or newsletter-subscription invitation (st.ignoreInvitation action). Set invitationType and provide only its matching URL. If this workflow is still running, do not retry this tool; retrying can queue duplicate ignore attempts. Linked API actions are q
remove_connectionAllows you to remove a person from your connections (st.removeConnection action). If this workflow is still running, do not retry this tool; retrying can queue duplicate removal attempts for the same person. Linked API actions are queued into a cloud-browser workflow and may take several minutes. T
search_companiesAllows you to search for companies applying various filtering criteria (st.searchCompanies action). Every company in the result carries urn — its permanent LinkedIn organization URN (urn:li:organization:<id>), or null when LinkedIn does not expose it. Linked API actions are queued into a cloud-brow
search_peopleAllows you to search people applying various filtering criteria (st.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. Every person also carries viewerState.connectionDegree — your connect
search_jobsAllows you to search jobs applying various filtering criteria (st.searchJobs action). LinkedIn serves either a classic or an AI-powered jobs search, and the two do not offer the same refinements: send filter for the classic one or preferences for the AI-powered one, never both. Every job in the resu
search_postsAllows you to search posts applying various filtering criteria (st.searchPosts action). Either term or customSearchUrl must be provided, and when customSearchUrl is specified, filter is ignored entirely and only the facets already encoded in the URL are applied. LinkedIn widens a narrow query on its
fetch_companyAllows you to open a company page to retrieve its basic information (st.openCompanyPage action). Can optionally retrieve employees, posts and decision makers. The basic information carries urn — the permanent LinkedIn organization URN of the company (urn:li:organization:<id>); retrieved employees an
fetch_personAllows you to open a person page to retrieve their basic information and perform additional person-related actions if needed. (st.openPersonPage action). Allows additional optional retrieval of experience, education, skills, languages, posts, comments and reactions. The basic information carries urn
endorse_person_skillEndorses one skill by name on a 1st-degree connection's profile. Skill names are in the profile owner's language, regardless of your LinkedIn language. An already-endorsed skill counts as success and is never removed. Every success, including an existing endorsement, counts toward the stEndorsements
endorse_person_skillsEndorses selected skills of a 1st-degree connection, returning each selected skill's name, success and error if it failed. Skill names are in the profile owner's language. Patterns use RE2, are case-insensitive and match anywhere; anchor with ^…$ to match a whole name. Omit skillNamePatterns to endo
fetch_postOpen a LinkedIn post and retrieve its data, with optional comments and reactions. (st.openPost action). The author and reposter carry urn — a member URN (urn:li:member:<id>) for a person actor and an organization URN (urn:li:organization:<id>) for a company actor — and each retrieved reaction carrie
fetch_jobOpen a LinkedIn job and retrieve its details such as company, location, salary, and description (st.openJob action). The result carries urn — the permanent LinkedIn job posting URN (urn:li:jobPosting:<jobId>) — which is null when LinkedIn does not expose the identifier. Linked API actions are queue
react_to_postAllows you to react to a post using any available reaction type (st.reactToPost action). If this workflow is still running, do not retry this tool; retrying can queue duplicate reaction attempts. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server re
comment_on_postAllows you to leave a comment on a post (st.commentOnPost action); returns the comment's URN and URL. If this workflow is still running, do not retry this tool; retrying can post duplicate comments. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server
react_to_commentReact to a comment by commentUrl (like, love, support, celebrate, insightful, funny). If this workflow is still running, do not retry this tool; retrying can queue duplicate reaction attempts. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server retur
reply_to_commentReply to a comment by commentUrl; returns the reply's URN and URL. If this workflow is still running, do not retry this tool; retrying can post duplicate replies. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after starting
create_postCreates a new LinkedIn post with optional mentions and media attachments (st.createPost action). Returns the URL and URN of the new post. If this workflow is still running, do not retry this tool; retrying can create duplicate posts. Linked API actions are queued into a cloud-browser workflow and m
create_repostReposts a LinkedIn post, either as is or with your own commentary (st.createRepost action). Returns the URL and URN of the repost itself, which is a post of your own account, not of the post that was reshared. Reposting the same post twice from the same account fails with alreadyReposted. If this wo
retrieve_feedRetrieves posts from the current account's personalized LinkedIn home feed (st.retrieveFeed action). Each post's author and reposter carry urn — a member URN (urn:li:member:<id>) for a person actor and an organization URN (urn:li:organization:<id>) for a company actor, or null when LinkedIn does not
retrieve_profile_viewersRetrieves the people who recently viewed the current account's LinkedIn profile (st.retrieveProfileViewers action). Each entry is either identified — carrying name, publicUrl and urn (a member URN urn:li:member:<id>, null when LinkedIn does not expose it) — or anonymous, carrying only the descriptio
retrieve_ssiAllows you to retrieve your current SSI (Social Selling Index) (st.retrieveSSI action). Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after starting the workflow with {status: 'pending'|'running', pendingReason, workflowId,
retrieve_performanceAllows you to retrieve performance analytics from your LinkedIn dashboard (st.retrievePerformance action). Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately after starting the workflow with {status: 'pending'|'running', pendingR
nv_send_messageAllows you to send a message to a person in Sales Navigator (nv.sendMessage action). Provide either personUrl or threadId (threadId replies into an existing conversation thread and takes precedence). If this workflow is still running, do not retry this tool; retrying can send duplicate Sales Navigat
nv_sync_inboxRecommended first step before reading Sales Navigator messages. Enable whole-inbox monitoring in Sales Navigator so every incoming conversation can be polled with get_inbox (nv.syncInbox action). Run once per account, before sending messages whose replies you want to read; only messages that arrive
nv_sync_conversationLoads this person's earlier Sales Navigator message history (nv.syncConversation action). Call once per person. Do not call it to check for new messages – use get_inbox. After it completes, read the history with get_inbox and personUrl. Linked API actions are queued into a cloud-browser workflow an
nv_get_conversationLegacy. Prefer get_inbox with personUrl. Retrieve a conversation with a LinkedIn person via Sales Navigator messaging. Returns the conversation immediately if it has already been synced. If the conversation has not been synced yet, this tool starts an nvSyncConversation workflow and returns its ack
nv_manage_conversationArchive or unarchive a Sales Navigator conversation thread by threadId (nv.manageConversation action). Provide the threadId as returned by get_inbox and the operation to perform. Linked API actions are queued into a cloud-browser workflow and may take several minutes. The server returns immediately
nv_search_companiesAllows you to search for companies in Sales Navigator applying various filtering criteria. (nv.searchCompanies action). Every company in the result carries urn — its permanent LinkedIn organization URN (urn:li:organization:<id>), or null when LinkedIn does not expose it. Linked API actions are queu
nv_search_peopleAllows you to search people in Sales Navigator applying various filtering criteria. (nv.searchPeople action). Every person in the result carries urn — their permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. The same person carries the same urn in standard
nv_fetch_companyAllows you to open a company page in Sales Navigator to retrieve its basic information (nv.openCompanyPage action). Can optionally retrieve employees and decision makers. The basic information carries urn — the permanent LinkedIn organization URN of the company (urn:li:organization:<id>) — and retri
nv_fetch_personAllows you to open a person page in Sales Navigator to retrieve their basic information (nv.openPersonPage action). The result carries urn — the person's permanent LinkedIn member URN (urn:li:member:<id>) — and companyUrn for their current company (urn:li:organization:<id>); either is null when Link
execute_custom_workflowExecute a custom workflow definition. Pass a single action with actionType and its parameters at the top level. A single-action or array definition can alternatively be passed in definition. If this workflow is still running, do not retry this tool; retrying can duplicate any write actions inside th
get_workflow_resultCheck the current state of a previously started Linked API workflow. Returns the final result when the workflow has completed, otherwise returns the current in-progress snapshot ({status, pendingReason, workflowId, operationName, message}). The server long-polls up to waitSeconds while the workflow
get_api_usageRetrieve Linked API usage statistics. Date range must not exceed 30 days.
send_feedbackSend product feedback about Linked API straight to the Linked API team. The team welcomes any feedback, positive or negative: use it when the user reports a problem, is unhappy with a result, asks for something Linked API cannot do yet, or praises it — and whenever a Linked API tool keeps failing or
admin_get_subscription_statusGet current subscription status, trial eligibility, and cancellation schedule.
admin_get_seatsGet active subscription seats. Each seat allows one connected LinkedIn account. Seat types: core (standard) and plus (includes Sales Navigator).
admin_set_seatsSet number of subscription seats. Returns checkout link if no active subscription, otherwise updates immediately.
admin_get_accountsGet all connected LinkedIn accounts and pending connection sessions.
admin_reparse_account_infoRefresh stored profile information for a connected account. Starts a background reparse workflow and returns workflowId.
admin_create_reconnection_sessionCreate a reconnection session for an account with status reconnection_required. Returns reconnectionSessionId and reconnectionLink.
admin_connect_accountCreate a connection session to connect a new LinkedIn account. Returns a sessionId and connectionLink that must be opened in a browser.
admin_get_connection_sessionGet connection or reconnection session status by session ID.
admin_cancel_connection_sessionCancel a pending connection or reconnection session.
admin_disconnect_accountDisconnect a LinkedIn account. This action is irreversible — the account must be reconnected from scratch.
admin_regenerate_tokenRegenerate identification token for an account. The old token becomes invalid immediately.
admin_get_limits_defaultsGet system default rate limits.
admin_get_limitsGet configured rate limits for an account.
admin_get_limits_usageGet current usage against configured rate limits for an account.
admin_set_limitsSet rate limits for an account. Only specified limits are created or updated; other limits remain unchanged. Categories: stPersonProfileViews, stCompanyPageViews, stConnectionRequests, stMessages, stSearchQueries, stReactions, stComments, stPosts, stEndorsements, nvPersonProfileViews, nvCompanyPageV
admin_delete_limitsDelete specific rate limits for an account. Each removed category/period has no limit until set again. Use admin_reset_limits to restore all default limits for the account.
admin_reset_limitsReset all rate limits for an account to the system defaults.
get_changelogRead the public Linked API changelog: what was released and when, newest first. Use it when the user asks what is new or recently changed in Linked API, or whether Linked API supports something yet — a capability may have shipped recently, so check here before saying it does not exist. Each release