Services Lookup
get_api_v1_g_services_lookupsearch for a keyword and get relevent services with their IDs Group: services. Billing per call: 1 Credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No |
get_api_v1_g_services_lookupsearch for a keyword and get relevent services with their IDs Group: services. Billing per call: 1 Credits.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Without annotations, description discloses the cost ('Billing per call: 1 Credits') and that it returns service IDs, implying a read-only lookup. However, it omits auth requirements, pagination, response format, 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?
Two concise sentences; front-loaded with action and resource. Minor issues: misspelling 'relevent' and cryptic 'Group: services' fragment detract slightly.
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?
For a simple single-param lookup, it covers the basic function and billing, but lacks return shape, usage context vs siblings, and query parameter constraints. Adequate but with clear gaps.
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?
One parameter (query) has no schema description; description adds that it is a keyword for searching services. But doesn't clarify optionality (schema has required: 0) or accepted syntax/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?
Clearly states a search/lookup action on services producing IDs. The verb 'search' and resource 'services' are explicit, but it doesn't differentiate from sibling get_api_v1_search_services.
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 on when to use this over get_api_v1_search_services or service detail endpoints. Usage is only implied as keyword lookup.
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.