Skip to main content
Glama
abukreev-dev

keyso-mcp

by abukreev-dev

keyso_delete_ai_tracker_id_competitors

Deletes competitor records from an AI tracker by its ID, removing outdated or unwanted entries to keep analysis data accurate.

Instructions

Трекер ИИ - удаление конкурентов Method: DELETE Path: /ai_tracker//competitors Пример запроса https://api.keys.so/ai_tracker/<id>/competitors

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesin: path (auto-detected)
bodyYesJSON body
tokenNoAPI token override (fallback: KEYSO_TOKEN env)
base_urlNoOverride API base URL

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

C2.9/5.0
Behavior2/5

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

With no annotations, the description carries the full burden of behavioral disclosure. It does reveal that this is a DELETE operation and implies destructive removal of competitors, which is helpful. However, it does not explain whether all competitors are removed, whether the request body selects specific competitors, whether the operation is reversible, or what happens if the id is invalid.

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-loaded with the purpose, followed by method and path. The example URL is slightly redundant with the path, but the overall structure is clean and free of filler. It is not bloated, though it errs on the side of being too sparse.

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?

For a tool with no annotations, no output schema, and a required but opaque JSON body, this description is incomplete. An agent cannot reliably construct a valid request body or understand the exact scope of the deletion. The method and path alone are not enough for correct invocation.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3 even though the description itself adds little parameter detail. The path example demonstrates how id is used, but the required 'body' parameter remains semantically empty in both schema and description, leaving the actual competitor-deletion payload unspecified.

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 the action clearly: 'Трекер ИИ - удаление конкурентов' translates to 'AI Tracker - delete competitors', which identifies the verb (delete) and resource (competitors of an AI tracker). It is distinguishable from sibling delete_ai_tracker_id and delete_ai_tracker_id_prompts, though it does not explicitly contrast itself with post_ai_tracker_id_competitors or get_ai_tracker_id_competitors.

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?

No guidance is given about when to use this tool versus alternatives, what prerequisites exist, or what body payload is required. The Method and Path lines are useful but do not constitute usage guidance for an agent deciding between this and sibling competitor-related tools.

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

Deploy Server

Other Tools