Skip to main content
Glama

Watch an RSS feed for new items

watch_rss_feed

Monitor an RSS or Atom feed between agent runs and alert once per new item. Includes 7 days of polling. Costs $0.005 USDC per call via x402 (Base) — no API key, no account. Calling without payment returns 402 with the payment requirements. Free alternative: GET https://longwatch.dev/demo for a free NVDA Form 4 sample, or POST https://longwatch.dev/try for a 24h watch — no wallet needed.

Input Schema

NameRequiredDescriptionDefault
urlYespublic RSS or Atom feed URL
webhookNooptional HTTPS endpoint for signed push alerts; polling still works
idempotency_keyNounique retry key; the same key and input return the original watch

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / webhook / properties / url / description
      Added value: +"Public HTTPS webhook URL, e.g. https://example.com/alerts"
  2. Added

TDQS

A3.8/5.0
Behavior5/5

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

Goes well beyond the annotations: discloses pricing ($0.005 USDC via x402 on Base), that no API key or account is needed, that an unpaid call returns 402 with payment requirements, and the 7-day polling retention window. These are exactly the operational facts an agent needs that annotations (readOnlyHint=false, openWorldHint=true) cannot convey.

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?

Purpose and delivery semantics are front-loaded in the first sentence, and the payment/error behavior follows logically. The trailing 'Free alternative' sentence carries two raw URLs and reads partly as promotion, which is useful but slightly bloats an otherwise tight definition.

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

Completeness3/5

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

With no output schema and a nested webhook object, the description should say what the call returns (e.g. a watch identifier) and how new items are later retrieved via poll_alerts. It covers cost and lifetime well but leaves the post-creation workflow and the webhook-vs-polling relationship unexplained.

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 url, webhook, and idempotency_key are already documented in structured fields; baseline 3 applies. The description adds nothing parameter-level — it never mentions the optional webhook push or the idempotency key's retry semantics, so it neither reinforces nor compensates.

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?

States a specific verb and resource ('Monitor an RSS or Atom feed') plus the behavioral distinction that matters most: it runs 'between agent runs' and fires 'once per new item', which implicitly separates it from the one-shot check_rss_feed. However, it never names that sibling or create_watch/try_watch, leaving the agent to infer the boundary from the word 'monitor'.

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 paid/free distinction is spelled out (free demo GET and free 24h try POST endpoints), which is genuine routing guidance for a paid tool. But there is no guidance on when to pick this over the sibling tools check_rss_feed, create_watch, or try_watch, so the core when-to-use decision is left implied by the title alone.

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.

Resources