Skip to main content
Glama

Remove from a watchlist

watchlists_remove_symbols
Destructive

Removes markets from one of the signed-in member's watchlists (its id from watchlists_list). Name each one as watchlists_list shows it (source:TICKER) or by its bare symbol ("AAPL", "BTCUSD"), which removes every row of that symbol. The list itself stays; this server cannot delete a watchlist. Returns what was removed and what was not found. It changes the member's account, so the chat app may ask the user to confirm first. Requires signing in with a LuxAlgo account (OAuth).

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": {
      "watchlist_id": "<watchlist_id>",
      "symbols": "<symbols>",
      "context": "<context>"
    },
    "name": "watchlists_remove_symbols"
  }
}

Input Schema

NameRequiredDescriptionDefault
contextYesExplain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution."
symbolsYesMarkets to remove: "binance:BTCUSDT", or a bare symbol such as "AAPL".
watchlist_idYesThe watchlist's id, from watchlists_list.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.7/5.0
Behavior5/5

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

Goes well beyond the destructiveHint/openWorldHint annotations by explaining the return payload (what was removed and what was not found), the requirement for OAuth sign-in, and the confirmation prompt the chat app may surface. It also clarifies the blast radius of a bare symbol, which is a non-obvious destructive behavior not encoded anywhere in the schema.

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?

Front-loads the core action, then layers format rules, non-capabilities, return shape, side effects, and auth in descending order of importance. Every sentence carries information an agent would otherwise have to guess; there is no filler.

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

Completeness5/5

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

There is no output schema, and the description compensates by describing the removal/not-found result. For a destructive three-parameter mutation tool, the auth requirement, confirmation behavior, and non-deletion guarantee cover everything needed to call it correctly.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description earns more by explaining the behavioral difference between the two symbol forms — a bare symbol removes every matching row, which the schema does not convey. It also states where watchlist_id comes from, adding provenance beyond the schema's description.

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?

States a specific verb and resource ("Removes markets from one of the signed-in member's watchlists") and immediately distinguishes scope from siblings: the list row is not deleted, only entries. It also clarifies that watchlist deletion is not supported, which separates it from watchlists_create and from a hypothetical delete tool.

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

Usage Guidelines4/5

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

Gives concrete when-to-use context (member's watchlist, id sourced from watchlists_list) and explicit acceptance of two symbol formats with the consequence of each. It also rules out one alternative (deleting a whole watchlist). It doesn't explicitly name watchlists_add_symbols as the counterpart, but the direction of the operation makes that unambiguous.

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.