Revnu

Get LinkedIn Person

linkedin_person

Read-onlyIdempotent

One person's LinkedIn relationship with each of the customer's connected LinkedIn accounts (or the one named in account): whether they're connected, any pending invite and when it was sent, Revnu's own invite record with when it saw acceptance, and the newest 50 messages with who sent each. profile is a linkedin.com/in/ URL or id. Read live from LinkedIn: each account is one paced profile lookup, so look people up as you need them rather than in bulk. Read-only.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`account`	No	Name of a connected LinkedIn account. Omit to inspect every connected account; one paced profile lookup per account.
`profile`	Yes	A linkedin.com/in/ profile URL or LinkedIn profile ID from the customer or a lead contact.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`person`	Yes	First successfully resolved profile across the selected accounts. Null when no account resolves it; inspect accounts.state for the reason.
`accounts`	Yes	One result per selected account. Inspect state before using relationship or conversation fields; one account can fail while another succeeds.

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedOct 15, 2026

changedOutput schema / properties / accounts / description

Previous value: -"Connection, invitation and conversation state per connected account."New value: +"One result per selected account. Inspect state before using relationship or conversation fields; one account can fail while another succeeds."

removedOutput schema / properties / accounts / items / additionalProperties
```
Removed value: -true
```

addedOutput schema / properties / accounts / items / anyOf

Added value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "account": {
+        "description": "Connected account label; pass it as linkedin_person.account to read only this account.",
+        "type": "string"
+      },
+      "connected": {
+        "description": "True when LinkedIn reports a first-degree connection to this person.",
+        "type": "boolean"
+      },
+      "connectedAs": {
+        "description": "Connected LinkedIn identity label, or null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "invite": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "at": {
+                "description": "Invitation creation time as Unix epoch milliseconds, or null when unavailable.",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "direction": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "sent",
+                      "received"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Who initiated the invitation, or null when LinkedIn does not identify a direction."
+              },
+              "status": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "pending",
+                      "ignored",
+                      "withdrawn"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Invitation state reported by the relationship lookup."
+              }
+            },
+            "required": [
+              "direction",
+              "status",
+              "at"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "LinkedIn's invitation state; null for an existing connection or no visible invitation."
+      },
+      "lastReplyAt": {
+        "description": "Time of the newest incoming entry in the returned history, as Unix epoch milliseconds; null if none is present.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "messages": {
+        "description": "Newest conversation entries, merged across inboxes and returned oldest first. An empty array means no visible messages.",
+        "items": {
+          "additionalProperties": true,
+          "properties": {
+            "at": {
+              "description": "Message time as Unix epoch milliseconds.",
+              "type": "number"
+            },
+            "from": {
+              "description": "Whether the connected account or the looked-up person sent this entry.",
+              "enum": [
+                "you",
+                "them"
+              ],
+              "type": "string"
+            },
+            "kind": {
+              "description": "Conversation entry type; events and invitations may have no text.",
+              "enum": [
+                "message",
+                "event",
+                "inmail",
+                "invitation"
+              ],
+              "type": "string"
+            },
+            "sentBy": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "agent",
+                    "person"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "For outgoing messages: agent means Revnu, person means a human in Revnu's inbox, and null means native LinkedIn or unknown. Incoming entries are null."
+            },
+            "text": {
+              "description": "Message or event text, or null when unavailable.",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "at",
+            "from",
+            "sentBy",
+            "kind",
+            "text"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "messagesTruncated": {
+        "description": "True when older messages or additional inboxes were omitted; history is limited to 50 entries from up to three chats.",
+        "type": "boolean"
+      },
+      "revnuInvite": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "acceptedAt": {
+                "description": "When Revnu observed acceptance, or null when not recorded.",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "sentAt": {
+                "description": "When Revnu sent its most recent invitation from this account, as Unix epoch milliseconds.",
+                "type": "number"
+              },
+              "withdrawnAt": {
+                "description": "When the invitation was withdrawn, or null when not recorded.",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "sentAt",
+              "acceptedAt",
+              "withdrawnAt"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Revnu's own invitation history, independent of LinkedIn's current invite state; null if Revnu has no record."
+      },
+      "state": {
+        "const": "ok",
+        "description": "The profile and conversation lookup succeeded for this account.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "account",
+      "connectedAs",
+      "state",
+      "connected",
+      "invite",
+      "revnuInvite",
+      "messages",
+      "messagesTruncated",
+      "lastReplyAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "account": {
+        "description": "Connected account label; pass it as linkedin_person.account to read only this account.",
+        "type": "string"
+      },
+      "connectedAs": {
+        "description": "Connected LinkedIn identity label, or null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "state": {
+        "const": "not_connected",
+        "description": "This account has no usable LinkedIn connection; relationship and conversation fields are unavailable.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "account",
+      "connectedAs",
+      "state"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "account": {
+        "description": "Connected account label; pass it as linkedin_person.account to read only this account.",
+        "type": "string"
+      },
+      "connectedAs": {
+        "description": "Connected LinkedIn identity label, or null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "state": {
+        "const": "needs_reauth",
+        "description": "This account must reconnect LinkedIn before the lookup can proceed.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "account",
+      "connectedAs",
+      "state"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "account": {
+        "description": "Connected account label; pass it as linkedin_person.account to read only this account.",
+        "type": "string"
+      },
+      "connectedAs": {
+        "description": "Connected LinkedIn identity label, or null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "Why the lookup is paced.",
+        "type": "string"
+      },
+      "retryAt": {
+        "description": "Earliest retry time as Unix epoch milliseconds; wait until then before retrying this account.",
+        "type": "number"
+      },
+      "state": {
+        "const": "paced",
+        "description": "The profile read was deferred by account pacing, not a missing relationship.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "account",
+      "connectedAs",
+      "state",
+      "message",
+      "retryAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "account": {
+        "description": "Connected account label; pass it as linkedin_person.account to read only this account.",
+        "type": "string"
+      },
+      "connectedAs": {
+        "description": "Connected LinkedIn identity label, or null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "message": {
+        "description": "Lookup failure detail, such as an unresolved profile or unavailable conversation.",
+        "type": "string"
+      },
+      "state": {
+        "const": "error",
+        "description": "This account's lookup failed; do not interpret absent relationship data as disconnected.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "account",
+      "connectedAs",
+      "state",
+      "message"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / accounts / items / properties
```
Removed value: -{}
```
removedOutput schema / properties / accounts / items / type
```
Removed value: -"object"
```

changedOutput schema / properties / person / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {},
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "headline": {
+        "description": "LinkedIn profile headline, or null when not returned.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "description": "Profile name assembled from the returned first and last names, or null when unavailable.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "providerId": {
+        "description": "LinkedIn's provider identifier for this person, or null when not returned.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "publicIdentifier": {
+        "description": "Public profile slug from linkedin.com/in/<slug>, or null when not returned.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "providerId",
+      "publicIdentifier",
+      "name",
+      "headline"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / person / description

Previous value: -"Resolved LinkedIn person, or null when unresolved."New value: +"First successfully resolved profile across the selected accounts. Null when no account resolves it; inspect accounts.state for the reason."

Changed3 schema fields changedOct 15, 2026

addedInput schema / properties / account / description

Added value: +"Name of a connected LinkedIn account. Omit to inspect every connected account; one paced profile lookup per account."

addedInput schema / properties / profile / description

Added value: +"A linkedin.com/in/ profile URL or LinkedIn profile ID from the customer or a lead contact."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": true,
+  "properties": {
+    "accounts": {
+      "description": "Connection, invitation and conversation state per connected account.",
+      "items": {
+        "additionalProperties": true,
+        "properties": {},
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "person": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "properties": {},
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Resolved LinkedIn person, or null when unresolved."
+    }
+  },
+  "required": [
+    "person",
+    "accounts"
+  ],
+  "type": "object"
+}

AddedOct 1, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and openWorldHint, so safety is covered; the description adds genuinely new behavior: the data is read live from LinkedIn (freshness), lookups are paced per account (cost/rate context), and the message payload is capped at the newest 50. It stops short of noting pagination or failure behavior for a private/nonexistent profile.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Every sentence carries information — result shape, parameter format, lookup cost, and read-only status — with no filler. It is dense rather than front-loaded around a single purpose statement, and the trailing 'Read-only' partially duplicates the readOnlyHint annotation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so describing return fields is not strictly required, yet the description usefully frames what the caller gets. Combined with the pacing/cost note and parameter format, an agent has enough to call it correctly; the only omission is behavior when the profile is not found or not connected.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description goes further by spelling out the cross-parameter consequence of omitting `account` (one paced lookup per connected account) and restating that `profile` accepts a URL or id. That cost implication is not encoded in the schema and is useful for invocation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the exact resource (one person's LinkedIn relationship across the customer's connected accounts) and enumerates the returned facets — connection status, pending invite timing, Revnu's invite record, and the newest 50 messages. It is unambiguous and clearly distinct from the sibling tools, which deal with leads, reviews, and workflows.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete operational guidance: look people up on demand rather than in bulk because each connected account costs one paced profile lookup, and it explains that omitting `account` inspects every connected account. It does not explicitly name an alternative tool, but there is no sibling that overlaps, so no exclusion is needed.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Revnu tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?