Skip to main content
Glama

SHAR Public Knowledge MCP

Get public clients

get_public_clients
Read-onlyIdempotent

Retrieve only owner-approved public client relations.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observed

TDQS

A3.7/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the description does not need to cover basic safety behaviors. The description adds the 'owner-approved' filter as a scope qualifier, but does not disclose any additional behavioral traits such as auth requirements or rate limits. No contradiction with annotations exists.

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

Conciseness5/5

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

The description is a single sentence that front-loads the action, target, and scope. There is no unnecessary repetition or filler, making it highly efficient.

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?

For a straightforward read-only retrieval with one optional parameter, the description plus the schema and annotations provide a workable contract. The lack of an output schema and the absence of explicit return-shape details are minor given the simple nature of the tool, but adding them would make it fully complete.

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

Parameters2/5

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

The schema has 0% description coverage for the only parameter, 'limit', and the tool description does not mention it at all. Because the description was expected to compensate for the low schema coverage, this is a gap even though the parameter's name and constraints are relatively self-explanatory.

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 states a specific verb ('Retrieve') and resource ('public client relations') with a clear scope modifier ('only owner-approved'). This clearly distinguishes it from sibling get_* tools such as get_public_evidence or get_organization_facts.

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

Usage Guidelines3/5

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

The description implies it should be used when owner-approved public client relations are needed, but it does not explicitly state when to prefer this tool over siblings or when not to use it. No alternatives or exclusions are mentioned, so the guidance is only implied.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

B3.4/5.0
Disambiguation4/5

Each tool targets a different public knowledge resource (cases, services, evidence, provenance, clients), so an agent can usually tell them apart. However, get_industry_experience overlaps with search_cases, and get_public_evidence versus get_media_provenance could be confused without careful reading.

Naming Consistency5/5

All tool names follow a consistent snake_case verb_noun pattern, with get_ as the dominant verb and list_/search_/compare_ as clear variants. No camelCase or inconsistent verb styles appear.

Tool Count4/5

15 tools sits at the upper edge of a well-scoped read-only knowledge server. Each tool has a distinct purpose, but a few could be consolidated (e.g., industry experience as a search_cases filter) without losing capability.

Completeness4/5

The surface covers the main public knowledge workflows: service catalog, cases, evidence, provenance, pricing, clients, and production context. Minor gaps exist, such as no direct get_claim stable-identifier lookup and no list_cases endpoint, but search_knowledge and search_cases provide workarounds.

Resources