Skip to main content
Glama

Recent Alerts

recent_alerts
Read-onlyIdempotent

Pull fired events from your subscription feed. Returns the most recent alerts the evaluator has written to your persisted feed — each carries source, citation_uri (pipeworx:// when available), and the raw event payload. Filter by type (e.g. "sec_8k") and/or since (ISO timestamp). Set mark_read:true to flag returned events read so the next call only shows newer ones. Polls work fine; the same feed is also at GET registry.pipeworx.io/alerts.json for scripts and dashboards.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
typeNoOptional — filter to one subscription type.
limitNoMax events to return (1-200, default 50).
sinceNoOptional ISO timestamp — return events fired_at >= this time.
mark_readNoFlag the returned events read in the same call (default false).
unread_onlyNoReturn only events where read_at is null (default false).

TDQS

A3.6/5.0
Behavior1/5

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

The description discloses the mark_read side effect ('flag returned events read so the next call only shows newer ones'), which is valuable behavior context. However, this directly contradicts the annotation readOnlyHint: true, which states the tool does not modify state. This is an annotation contradiction, so score is 1.

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?

The description is efficiently written, front-loads the purpose, and each sentence adds value (returns, filtering, mark_read, polling/alternative endpoint). No fluff.

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

Completeness4/5

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

The description explains what the tool returns (source, citation_uri, raw payload), how to filter, mark_read behavior, and polling suitability. With 5 optional params and no output schema, this is reasonably complete. The unread_only param is left to schema, which is acceptable.

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 coverage is 100%, so baseline is 3. The description adds a concrete example type 'sec_8k' and explains the effect of mark_read, but the schema already describes all parameters. No significant extra parameter meaning.

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?

The description opens with a specific verb+resource: 'Pull fired events from your subscription feed.' It clearly identifies the tool's scope (alerts from subscription feed) and distinguishes it from sibling tools like list_subscriptions (which manages subscriptions) and recent_changes (which may be about changes).

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?

The description gives clear context: filter by type and since, and mentions that polling works fine, plus an alternative access method via GET endpoint. However, it doesn't explicitly contrast with sibling tools like list_subscriptions, so no explicit exclusions.

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.

TDQS

A3.6/5.0
Disambiguation2/5

Several tool clusters overlap heavily: ask_pipeworx and ask_pipeworx_beta are documented as functionally identical right now, and polymarket_arbitrage / polymarket_edges / polymarket_edge_tracker all surface trade opportunities with similar outputs. discover_tools and suggest_questions also cover similar 'what can I do' territory.

Naming Consistency3/5

All names are snake_case and many use verb_noun (query_layer, resolve_entity, generate_llms_txt), but a large minority use noun/adjective phrases (layer_info, recent_changes, polymarket_edges, bet_research) or bare verbs (remember, forget, recall). The pattern is readable but not fully predictable.

Tool Count2/5

34 tools is over the 25-tool threshold and deeply mismatched with the server name: only 3 of them (search_datasets, query_layer, layer_info) relate to ArcGIS Albuquerque. Most of the surface is a general-purpose Pipeworx data platform, making the set bloated and unfocused.

Completeness2/5

The advertised ArcGIS domain has only search-schema-query coverage: there is no way to list all datasets, apply spatial filters, or get service-level metadata. The Pipeworx half is feature-rich, but for the server as titled the tool surface has significant gaps and a large amount of irrelevant functionality.