tiktok_user_handle
Paid ($0.004). User handle — TikTok. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | Required. Path parameter. |
Paid ($0.004). User handle — TikTok. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | Required. Path parameter. |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description does disclose non-obvious operational facts: the call is paid ($0.004), returns live data as JSON, and requires payment via x402 or a bby_live_... Bearer key. However, it does not state whether the operation is read-only, what exactly it does, or what the JSON contains. Since annotations are absent, the description carries the full burden and only partially meets it.
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 admirably short and front-loads cost, but the core purpose is a fragment ('User handle — TikTok') that conveys little. While every clause adds some detail (payment, live data, format), the absence of a clear verb makes it under-specified rather than concise in the helpful sense.
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?
With one parameter and no output schema, the bar is low, yet the description still fails to state the basic operation and return contents. 'Live data as JSON' is the only return hint; a caller cannot know what fields to expect or how this tool differs from the many sibling TikTok tools. This is not enough for confident selection and invocation.
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 input schema documents username as a required path parameter with 100% coverage, so the description does not need to repeat it. The description adds no further semantic detail about username format (e.g., '@' symbol, normalization, length), so it sits at the baseline for high schema coverage.
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 says only 'User handle — TikTok,' a noun phrase that restates the tool name rather than stating an action. There is no verb like 'get' or 'resolve,' so an agent cannot tell whether this tool fetches user details, resolves handles to IDs, or performs some other operation. It does not differentiate from siblings such as tiktok_user_posts or tiktok_post_search.
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 when-to-use or when-not-to-use guidance is present. The description mentions payment and live data but never identifies the scenario for choosing this tool over siblings like tiktok_user_followers or tiktok_post_id. No alternatives are named.
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.