Profile details
get_api_v1_profile_detailsGet profile details information by URN Group: Profile. Billing per call: 1 Credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urn | No |
get_api_v1_profile_detailsGet profile details information by URN Group: Profile. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| urn | No |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It only says 'Get profile details' and mentions billing credits, but does not disclose any side effects (though it implies read-only), data returned, error handling, or rate limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and to the point, with no unnecessary verbosity. The billing note adds useful context without bloating the text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple (one parameter, no output schema), but the description omits crucial details such as what 'profile details' includes, what the response format is, and any potential error conditions. It is not sufficiently complete for an agent to confidently use it.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The sole parameter 'urn' has only an example, and the description does not explain what a URN is or how it relates to the profile. The schema coverage is minimal, and the description fails to compensate by clarifying the parameter's meaning or format.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Get') and resource ('profile details'), but it is somewhat redundant ('details information') and does not differentiate from other profile sub-endpoints like 'about' or 'education'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus the many sibling tools for specific profile aspects. The description does not mention alternatives or conditions that would make this the preferred choice.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Most tools target distinct resources (profiles, posts, companies, jobs), but there is notable overlap among profile-related endpoints (about, overview, details, full) and company insights vs. employees_data vs. insights. An agent could struggle to pick the right one without reading fine-grained descriptions.
The naming follows a consistent snake_case pattern starting with 'get_api_v1_', making it predictable. However, there are typos ('siilar', 'campany'), mixed terms (lookup vs. search vs. get), and extremely long redundant prefixes that reduce clarity, though the overall style is uniform.
With 50 tools, this is well above the 25-tool threshold, making the surface feel heavy and overwhelming. While the domain is broad (LinkedIn data), many endpoints could be consolidated (e.g., profile about/overview/details/full) to reduce the count without losing functionality.
For a read-only LinkedIn data API, the coverage is quite comprehensive: profiles, posts, companies, jobs, searches, geos, skills, and services are all represented. Obvious gaps are minimal—only a few advanced search filters or batch operations could be missing, but core data retrieval is well covered.