Merge pull request #20 from Linked-API/feat/urn

add urn support for entities

Author: LordOfTheVillage

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkedapi/mcp",
-  "version": "2.3.5",
+  "version": "2.3.6",
   "description": "MCP server that lets AI assistants control LinkedIn accounts and retrieve real-time data.",
   "main": "dist/index.js",
   "bin": {

src/tools/fetch-company.ts

@@ -44,7 +44,7 @@ export class FetchCompanyTool extends OperationTool<TFetchCompanyParams, unknown
     return {
       name: this.name,
       description:
-        'Allows you to open a company page to retrieve its basic information (st.openCompanyPage action). Can optionally retrieve employees, posts and decision makers.',
+        'Allows 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 and decision makers carry their own member urn (urn:li:member:<id>), and retrieved posts carry urn on their author and reposter. Each of them is null when LinkedIn does not expose the identifier.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/fetch-job.ts

@@ -15,7 +15,7 @@ export class FetchJobTool extends OperationTool<TBaseFetchJobParams, unknown> {
     return {
       name: this.name,
       description:
-        'Open a LinkedIn job and retrieve its details such as company, location, salary, and description (st.openJob action).',
+        'Open 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>) — and companyUrn for the hiring company (urn:li:organization:<id>); either is null when LinkedIn does not expose the identifier.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/fetch-person.ts

@@ -39,7 +39,7 @@ export class FetchPersonTool extends OperationTool<TFetchPersonParams, unknown>
   public override getTool(): Tool {
     return {
       name: this.name,
-      description: `Allows 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.
+      description: `Allows 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 — the person's permanent LinkedIn member URN (urn:li:member:<id>), or null when LinkedIn does not expose it. Retrieved posts carry urn on their author and reposter as well.
 ⚠️ **PERFORMANCE WARNING**: Only set additional retrieval flags to true if you specifically need that data. Each additional parameter significantly increases execution time:
 💡 **Recommendation**: Start with basic info only. Only request additional data if the user explicitly asks for it or if it's essential for the current task.
 `,

src/tools/fetch-post.ts

@@ -29,7 +29,7 @@ export class FetchPostTool extends OperationTool<TFetchPostParams, unknown> {
     return {
       name: this.name,
       description:
-        'Open a LinkedIn post and retrieve its data, with optional comments and reactions. (st.openPost action).',
+        'Open 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 retrieved reactions carry engagerUrn for the same identity; each is null when LinkedIn does not expose the identifier. This action reads identifiers from the post page itself, so it resolves actor URNs that post listings such as retrieve_feed cannot. Comment authors carry no URN.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/get-conversation.ts

@@ -57,7 +57,7 @@ operationName: OPERATION_NAME.syncConversation };
     return {
       name: this.name,
       description:
-        '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 ({status, workflowId, operationName: "syncConversation", message}); the client should call get_workflow_result with that workflowId until completion, then call get_conversation again to read the synced messages. The result carries syncUntil — the moment syncing of this conversation stops. Once it is in the past the messages are still returned but no longer updated; call sync_conversation again for the same person to resume updates.',
+        '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 ({status, workflowId, operationName: "syncConversation", message}); the client should call get_workflow_result with that workflowId until completion, then call get_conversation again to read the synced messages. The result carries syncUntil — the moment syncing of this conversation stops. Once it is in the past the messages are still returned but no longer updated; call sync_conversation again for the same person to resume updates. It also carries personUrn — the permanent LinkedIn member URN (urn:li:member:<id>) of the person, or null when LinkedIn does not expose it.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/get-inbox.ts

@@ -30,7 +30,7 @@ export class GetInboxTool extends LinkedApiTool<TInboxPollRequest, TInboxPollRes
     return {
       name: this.name,
       description:
-        'Get messages from the monitored inbox across all conversations (standard and Sales Navigator), newest first. Requires inbox monitoring to be enabled once with sync_inbox (or nv_sync_inbox for Sales Navigator).',
+        'Get messages from the monitored inbox across all conversations (standard and Sales Navigator), newest first. Requires inbox monitoring to be enabled once with sync_inbox (or nv_sync_inbox for Sales Navigator). Every message carries personUrn — the permanent LinkedIn member URN (urn:li:member:<id>) of the person on the other side of the thread, or null when LinkedIn does not expose it.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/get-network.ts

@@ -32,7 +32,7 @@ export class GetNetworkTool extends LinkedApiTool<TNetworkPollRequest, TNetworkP
     return {
       name: this.name,
       description:
-        'Get 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" (someone sent you a connection request).',
+        'Get 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" (someone sent you a connection request). Every event carries personUrn — the permanent LinkedIn member URN (urn:li:member:<id>) of the person the event is about, or null when LinkedIn does not expose it or the event was recorded before URNs were captured.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/nv-fetch-company.ts

@@ -38,7 +38,7 @@ export class NvFetchCompanyTool extends OperationTool<TNvFetchCompanyParams, unk
     return {
       name: this.name,
       description:
-        'Allows you to open a company page in Sales Navigator to retrieve its basic information (nv.openCompanyPage action). Can optionally retrieve employees and decision makers.',
+        'Allows 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 retrieved employees and decision makers carry their own member urn (urn:li:member:<id>); each is null when LinkedIn does not expose the identifier.',
       inputSchema: {
         type: 'object',
         properties: {

src/tools/nv-fetch-person.ts

@@ -15,7 +15,7 @@ export class NvFetchPersonTool extends OperationTool<TNvOpenPersonPageParams, un
     return {
       name: this.name,
       description:
-        'Allows you to open a person page in Sales Navigator to retrieve their basic information (nv.openPersonPage action).',
+        "Allows 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 LinkedIn does not expose it. The same person carries the same urn in standard interface results, so it can be used to match Sales Navigator results against them.",
       inputSchema: {
         type: 'object',
         properties: {