Skip to main content
Glama

Jsonplaceholder

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.3/5.0
Behavior4/5

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

The description adds valuable behavioral context beyond annotations, such as the OAuth requirement, phone verification for SMS, and the 10/day cap. It also explains delivery channels and how to access the feed. However, it omits the webhook option (which appears in the schema) and does not clarify idempotency semantics beyond the annotation, but the annotation already covers safety and idempotency.

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 fairly long but well-structured: it starts with the main purpose, then required auth, supported types, and delivery channels. Each section is informative without being redundant. It could be slightly more concise, but the density is justified by the tool's complexity.

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?

Given the complex schema (nested objects, 3 params) and 100% schema coverage, the description covers the essentials: purpose, auth requirement, supported types with examples, and delivery options. It omits webhook from the description text, and it doesn't mention all five types (patent_grant and clinical_trial are missing), but the schema fills these gaps. The description is sufficiently complete for the agent to select and invoke the tool 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?

The schema already has 100% coverage with detailed examples for each type, but the description adds extra semantic meaning, such as 'items:["5.02"] = officer change' and explaining 'polymarket_edge' as cross-venue mispricings. While not all types are repeated in the description, it enriches understanding of the ones it does mention.

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 tool's action: 'Create a proactive monitoring subscription to a live-data event stream' and mentions the return of a subscription ID. It distinguishes from sibling tools like list_subscriptions and unsubscribe by emphasizing proactive monitoring. The supported types further specify the resource.

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 provides clear context by stating the requirement for a Pipeworx OAuth account and explicitly notes alternatives for reading alerts (feed always on, pull via recent_alerts). While it doesn't explicitly say 'when not to use,' the prerequisites and alternative access implied are sufficient. It does not mention all use cases vs alternatives, but the guidance is helpful.

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

All Jsonplaceholder 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.7/5.0
Disambiguation2/5

Multiple tools overlap heavily: ask_pipeworx_beta is explicitly identical to ask_pipeworx, and ask_pipeworx, ask_pipeworx_grounded, deep_research, and validate_claim all serve natural-language question answering. The JSONPlaceholder get_* tools are distinct but introduce an unrelated domain, making tool selection ambiguous in practice.

Naming Consistency3/5

All names use lowercase snake_case, which is a consistent style, but there's no uniform verb_noun pattern. Tools mix action-first names (get_posts, remember, resolve_entity) with noun-oriented names (entity_profile, deep_research, pipeworx_trending). The naming is readable but not highly predictable.

Tool Count2/5

35 tools is far beyond the typical well-scoped range of 3-15. The set includes a full suite of Pipeworx/Polymarket tools plus a separate JSONPlaceholder demo namespace, making the server feel bloated and unfocused. Many meta-tools (discover_tools, suggest_questions, pipeworx_trending) could be consolidated.

Completeness2/5

The server's name and the get_posts/get_post/get_comments/get_users tools suggest a JSONPlaceholder fake API, but CRUD operations are missing: there's no create, update, or delete for posts, comments, or users, and no todos, albums, or photos. The unrelated Pipeworx/Polymarket tools don't address this core domain gap.

Resources