Skip to main content
Glama

Color

by io.github.pipeworx-io

Subscribe to Alerts

subscribe
Idempotent

Create a proactive monitoring subscription to a live-data event stream. Returns the new subscription id. Requires a Pipeworx OAuth account (anonymous + BYO cannot persist subscriptions). Supported types: "sec_8k" (8-K filings matching ticker + item codes — e.g. items:["5.02"] = officer change), "polymarket_edge" (Polymarket↔Kalshi cross-venue mispricings — params:{topic:"fed"}), "fred_series" (new FRED observations — params:{series_id:"UNRATE"}). Delivery channels: feed (always on — pull via recent_alerts or GET registry.pipeworx.io/alerts.json), and optionally email (set delivery:{email:"you@x.com"}) or sms (delivery:{sms:"+15551234567"} — phone must be verified at /account first; 10/day cap).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
typeYesSubscription type.
paramsYesType-specific filter. sec_8k: {ticker:"AAPL", items?:["5.02","1.01"]}. polymarket_edge: {topic:"fed", min_spread_bps?:500}. fred_series: {series_id:"UNRATE"}. patent_grant: {applicant:"Apple Inc."}. clinical_trial: {sponsor?:"Pfizer", condition?:"lung cancer", phase?:"PHASE3"} (sponsor or condition required).
deliveryNoOptional delivery channels in addition to the always-on persistent feed. {email:"you@x.com"} sends a templated alert per fired event. {sms:"+15551234567"} sends an SMS per event — must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:"https://..."} POSTs each event JSON to your endpoint, HMAC-signed — the response includes delivery.webhook_secret (whsec_…) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of "<X-Pipeworx-Timestamp>.<raw body>". Auto-disabled after 10 consecutive failing runs.

TDQS

A4.5/5.0
Behavior4/5

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

Description adds rich behavioral details: OAuth requirement, type-specific filters, delivery channel specifics, webhook HMAC signing and auto-disable. However, it contradicts the idempotentHint annotation by stating each subscription returns a new id and a unique secret, implying non-idempotent behavior.

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 well-structured with a clear flow (purpose, prerequisites, types, delivery), but it is slightly verbose. Nonetheless, every sentence contributes value.

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?

Given the tool's complexity (3 params with nested objects, no output schema), the description covers purpose, return value, prerequisites, all types with examples, all delivery options with detailed behavior, limitations, and error handling (auto-disable). No gaps for agent usage.

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

Parameters5/5

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

Schema coverage is 100%, and the description adds extensive context beyond the schema: type-specific examples (e.g., items codes for sec_8k), delivery format requirements, verification steps, and limitations (SMS cap, webhook auto-disable).

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 clearly states the verb 'Create' and the resource 'a proactive monitoring subscription to a live-data event stream', distinguishing it from sibling tools like list_subscriptions and unsubscribe.

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?

Provides explicit context: requires a Pipeworx OAuth account (anonymous/BYO cannot persist), delivery channels (feed always on, optional email/sms with caps), and type-specific parameters. Does not explicitly state when not to use, but the context is sufficient.

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

All Color toolsInspect
Try in Browser
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.9/5.0
Disambiguation2/5

Several tools are near-identical: ask_pipeworx and ask_pipeworx_beta are explicitly the same right now, and the three ask_pipeworx variants plus deep_research all route the same underlying catalog. The six polymarket_* tools also have heavily overlapping purposes, requiring deep reading to choose correctly. Most other tools are distinguishable, but these clusters create real misselection risk.

Naming Consistency3/5

The set is uniformly snake_case and mostly descriptive, with consistent micro-families like remember/recall/forget and polymarket_*. However, there is no single convention across the server: verb_noun names (ask_pipeworx, list_subscriptions) mix with noun-first names (entity_profile, bet_research, nearest_color), and the Pipeworx brand is used as both prefix and suffix. Readable but inconsistent.

Tool Count2/5

At 34 tools, the surface is far larger than a typical well-scoped server, and the count is especially unjustified for a server named 'Color' where only three tools relate to that name. The breadth stems from bolting a full data-research platform, prediction-market suite, memory store, and subscription system onto what appears to be a simple utility. Too heavy.

Completeness4/5

For the dominant Pipeworx research domain, the set is unusually thorough: query, grounded verification, deep research, entity resolution, comparisons, claim validation, change feeds, subscriptions, alerts, memory, and discovery are all present. Minor gaps exist (e.g., no direct account management tool, and color coverage only includes convert/contrast/nearest with no palette generation), but these are workaround-able. Completeness is strong for the real domain, if mismatched with the server name.

Resources