Phos Labs Commerce Intelligence

find_hidden_barriers

Read-only

Identify what's really blocking customers from converting — not what they say, but the actual capability gaps, missing motivation, and environmental friction. UNDERSTAND. 20 credits (€0.20 per call).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "behavior": "<behavior>",
      "population": "<population>"
    },
    "name": "find_hidden_barriers"
  }
}

Input Schema

Name	Required	Description	Default
`behavior`	Yes
`population`	Yes
`session_id`	No

Output Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 27, 2026

TDQS

C2.9/5.0

Behavior4/5

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

Annotations already establish that this is a safe, read-only, non-destructive, closed-world operation. The description adds useful behavioral context by disclosing the exact cost: 20 credits / €0.20 per call. It does not describe return shape, but an output schema exists, so the remaining gap is minor.

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?

The description is short and front-loads the core purpose before adding cost information. The standalone 'UNDERSTAND' tag is slightly opaque, but the overall structure is efficient and contains little waste.

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

Completeness2/5

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

The description covers purpose, contrast with self-reported barriers, and cost, and the output schema handles return values. However, for a tool with two required parameters and zero schema descriptions, omitting any explanation of behavior and population leaves the invocation critically under-specified.

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

Parameters1/5

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

Schema description coverage is 0%, and the description never mentions the behavior, population, or session_id parameters. It gives no indication of what these required inputs should contain or how they shape the analysis. With three undocumented parameters, the description completely fails to compensate for the schema gap.

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

Purpose4/5

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

The description states a specific diagnostic action: identifying hidden conversion barriers rather than self-reported reasons. It clarifies the kind of barriers (capability gaps, missing motivation, environmental friction), making the tool's purpose clear. It does not explicitly distinguish itself from sibling tools such as diagnose_dropoff or detect_biases, so it falls short of a 5.

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

Usage Guidelines2/5

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

The description offers only an implied usage context via 'UNDERSTAND' and the contrast with 'what they say.' It does not state when to use this tool versus alternatives like diagnose_dropoff, detect_biases, or predict_churn. An agent must infer the routing decision.

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

All Phos Labs Commerce Intelligence 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?