AlphAI

News Radar

alphai_radar

Read-onlyIdempotent

Rank news activity across the market or your saved AlphAI watchlist. Returns total story counts, model counts versus market-adjusted expectations, news tone and linked supporting headlines. Default: 20 tickers, 24h window, highest activity first. Use sentiment=negative or sort=sentiment_change with order=asc to find deteriorating news tone. Exact tickers intersect the selected scope; no alias expansion. Plans change added delay: Free 60 minutes, Basic 15 minutes, Pro none. Read as_of and freshness before describing recency; historical_preview means a fixed historical dataset, never a live reading. Only tickers with news in the chosen window appear. Missing metrics are null with a reason, not neutral. Scores describe observed news, not price forecasts or confirmed alerts. Follow next_cursor with identical filters and limit to keep the same snapshot; restart without cursor after snapshot_expired. Open a news evidence uid with alphai_article for the full enriched article. event_context adds separate issuer-CIK observations: 7-day 8-K/selected earnings 6-K filings and 30-day open-market insider clusters by latest SEC filing time, with sec_url links. For filings with has_article=true, open news_uid with alphai_article; news_title and news_published build its AlphAI URL. Article availability is frozen at the context cutoff; older snapshots default to false with null title/publication metadata. Read top-level event_context status/as_of and each row's event_context status before using counts. Null means unavailable, not zero; available does not certify complete SEC coverage. Context follows the same snapshot delay and cursors. It does not change news scores or row eligibility.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "alphai_radar"
  }
}

Input Schema

Name	Required	Description	Default
`sort`	No	Ranking metric; stories means total stories; sentiment_change is current minus prior tone.	score
`limit`	No	Rows per page, default 20; not a ticker entitlement.
`min_z`	No	Optional minimum descriptive activity score.
`order`	No	Sort direction; null metrics always last.	desc
`scope`	No	Market discovery or the authenticated caller's saved watchlist.	market
`cursor`	No	Opaque next_cursor or previous_cursor, unchanged.
`market`	No	Market filter within the selected scope.	all
`window`	No	News window ending at as_of.	24h
`tickers`	No	Optional comma-separated exact symbols, e.g. AAPL,MSFT,BTC-USD; no tier ticker cap.
`sentiment`	No	Positive >0.15, negative <−0.15, mixed within those bounds. Null matches only all.	all

Output Schema

Name	Required	Description	Default
`as_of`	Yes
`total`	Yes
`access`	Yes
`offset`	Yes
`window`	Yes
`results`	Yes
`freshness`	Yes
`limitations`	Yes
`next_cursor`	Yes
`snapshot_id`	Yes
`event_context`	No
`point_in_time`	Yes
`research_only`	Yes
`previous_cursor`	Yes
`watchlist_coverage`	Yes
`methodology_version`	Yes
`preview_reference_at`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 23, 2026

changedOutput schema / properties / results / items / properties / event_context / anyOf

Previous value: -[
-  {
-    "properties": {
-      "cik": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "cluster_buys": {
-        "default": [],
-        "items": {
-          "properties": {
-            "buyers": {
-              "type": "integer"
-            },
-            "evidence": {
-              "items": {
-                "properties": {
-                  "accession_number": {
-                    "type": "string"
-                  },
-                  "filed_at": {
-                    "format": "date-time",
-                    "type": "string"
-                  },
-                  "sec_url": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "accession_number",
-                  "filed_at",
-                  "sec_url"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "evidence_truncated": {
-              "type": "boolean"
-            },
-            "filings_count": {
-              "type": "integer"
-            },
-            "known_at": {
-              "format": "date-time",
-              "type": "string"
-            },
-            "officer_director_buyers": {
-              "type": "integer"
-            },
-            "pattern": {
-              "const": "open_market",
-              "default": "open_market",
-              "type": "string"
-            },
-            "window_end": {
-              "format": "date",
-              "type": "string"
-            },
-            "window_start": {
-              "format": "date",
-              "type": "string"
-            }
-          },
-          "required": [
-            "window_start",
-            "window_end",
-            "known_at",
-            "buyers",
-            "officer_director_buyers",
-            "filings_count",
-            "evidence",
-            "evidence_truncated"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "cluster_buys_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "filings": {
-        "default": [],
-        "items": {
-          "properties": {
-            "accession_number": {
-              "type": "string"
-            },
-            "event_date": {
-              "anyOf": [
-                {
-                  "format": "date",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "filed_at": {
-              "format": "date-time",
-              "type": "string"
-            },
-            "form": {
-              "enum": [
-                "8-K",
-                "6-K"
-              ],
-              "type": "string"
-            },
-            "items": {
-              "default": [],
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "kind": {
-              "anyOf": [
-                {
-                  "const": "earnings_release",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "news_uid": {
-              "type": "string"
-            },
-            "observed_at": {
-              "format": "date-time",
-              "type": "string"
-            },
-            "period_label": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "primary_item": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "sec_url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "form",
-            "accession_number",
-            "filed_at",
-            "observed_at",
-            "sec_url",
-            "news_uid"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "filings_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "enum": [
-              "non_sec_symbol",
-              "unknown_symbol",
-              "missing_cik",
-              "issuer_changed"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "status": {
-        "enum": [
-          "available",
-          "unsupported",
-          "unavailable"
-        ],
-        "type": "string"
-      },
-      "ticker": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "ticker",
-      "cik",
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "cik": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "cluster_buys": {
+        "default": [],
+        "items": {
+          "properties": {
+            "buyers": {
+              "type": "integer"
+            },
+            "evidence": {
+              "items": {
+                "properties": {
+                  "accession_number": {
+                    "type": "string"
+                  },
+                  "filed_at": {
+                    "format": "date-time",
+                    "type": "string"
+                  },
+                  "sec_url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "accession_number",
+                  "filed_at",
+                  "sec_url"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "evidence_truncated": {
+              "type": "boolean"
+            },
+            "filings_count": {
+              "type": "integer"
+            },
+            "known_at": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "officer_director_buyers": {
+              "type": "integer"
+            },
+            "pattern": {
+              "const": "open_market",
+              "default": "open_market",
+              "type": "string"
+            },
+            "window_end": {
+              "format": "date",
+              "type": "string"
+            },
+            "window_start": {
+              "format": "date",
+              "type": "string"
+            }
+          },
+          "required": [
+            "window_start",
+            "window_end",
+            "known_at",
+            "buyers",
+            "officer_director_buyers",
+            "filings_count",
+            "evidence",
+            "evidence_truncated"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "cluster_buys_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "filings": {
+        "default": [],
+        "items": {
+          "properties": {
+            "accession_number": {
+              "type": "string"
+            },
+            "event_date": {
+              "anyOf": [
+                {
+                  "format": "date",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "filed_at": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "form": {
+              "enum": [
+                "8-K",
+                "6-K"
+              ],
+              "type": "string"
+            },
+            "has_article": {
+              "default": false,
+              "description": "An enriched article existed before the context cutoff. False on older snapshots without metadata.",
+              "type": "boolean"
+            },
+            "items": {
+              "default": [],
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "kind": {
+              "anyOf": [
+                {
+                  "const": "earnings_release",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "news_published": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Article publication time for its AlphAI URL."
+            },
+            "news_title": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Article title frozen at the context cutoff."
+            },
+            "news_uid": {
+              "type": "string"
+            },
+            "observed_at": {
+              "format": "date-time",
+              "type": "string"
+            },
+            "period_label": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "primary_item": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "sec_url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "form",
+            "accession_number",
+            "filed_at",
+            "observed_at",
+            "sec_url",
+            "news_uid"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "filings_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "reason": {
+        "anyOf": [
+          {
+            "enum": [
+              "non_sec_symbol",
+              "unknown_symbol",
+              "missing_cik",
+              "issuer_changed"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "status": {
+        "enum": [
+          "available",
+          "unsupported",
+          "unavailable"
+        ],
+        "type": "string"
+      },
+      "ticker": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "ticker",
+      "cik",
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedSep 23, 2026

addedOutput schema / properties / event_context

Added value: +{
+  "properties": {
+    "age_seconds": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "as_of": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "cluster_lookback_days": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "filings_lookback_days": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "generated_at": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "identity_scope": {
+      "const": "issuer_cik",
+      "default": "issuer_cik",
+      "type": "string"
+    },
+    "max_age_seconds": {
+      "const": 300,
+      "default": 300,
+      "type": "integer"
+    },
+    "point_in_time": {
+      "const": false,
+      "default": false,
+      "type": "boolean"
+    },
+    "reason": {
+      "anyOf": [
+        {
+          "enum": [
+            "disabled",
+            "missing",
+            "stale",
+            "future",
+            "invalid",
+            "read_failed"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": "missing"
+    },
+    "status": {
+      "default": "unavailable",
+      "enum": [
+        "available",
+        "unavailable"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedOutput schema / properties / results / items / properties / event_context

Added value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "cik": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cluster_buys": {
+          "default": [],
+          "items": {
+            "properties": {
+              "buyers": {
+                "type": "integer"
+              },
+              "evidence": {
+                "items": {
+                  "properties": {
+                    "accession_number": {
+                      "type": "string"
+                    },
+                    "filed_at": {
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "sec_url": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "accession_number",
+                    "filed_at",
+                    "sec_url"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "evidence_truncated": {
+                "type": "boolean"
+              },
+              "filings_count": {
+                "type": "integer"
+              },
+              "known_at": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "officer_director_buyers": {
+                "type": "integer"
+              },
+              "pattern": {
+                "const": "open_market",
+                "default": "open_market",
+                "type": "string"
+              },
+              "window_end": {
+                "format": "date",
+                "type": "string"
+              },
+              "window_start": {
+                "format": "date",
+                "type": "string"
+              }
+            },
+            "required": [
+              "window_start",
+              "window_end",
+              "known_at",
+              "buyers",
+              "officer_director_buyers",
+              "filings_count",
+              "evidence",
+              "evidence_truncated"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "cluster_buys_count": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "filings": {
+          "default": [],
+          "items": {
+            "properties": {
+              "accession_number": {
+                "type": "string"
+              },
+              "event_date": {
+                "anyOf": [
+                  {
+                    "format": "date",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "filed_at": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "form": {
+                "enum": [
+                  "8-K",
+                  "6-K"
+                ],
+                "type": "string"
+              },
+              "items": {
+                "default": [],
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "kind": {
+                "anyOf": [
+                  {
+                    "const": "earnings_release",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "news_uid": {
+                "type": "string"
+              },
+              "observed_at": {
+                "format": "date-time",
+                "type": "string"
+              },
+              "period_label": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "primary_item": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
+              "sec_url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "form",
+              "accession_number",
+              "filed_at",
+              "observed_at",
+              "sec_url",
+              "news_uid"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "filings_count": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "reason": {
+          "anyOf": [
+            {
+              "enum": [
+                "non_sec_symbol",
+                "unknown_symbol",
+                "missing_cik",
+                "issuer_changed"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "status": {
+          "enum": [
+            "available",
+            "unsupported",
+            "unavailable"
+          ],
+          "type": "string"
+        },
+        "ticker": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "ticker",
+        "cik",
+        "status"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

AddedSep 20, 2026

TDQS

A4.2/5.0

Behavior5/5

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

Goes well past the annotations (readOnly/openWorld/idempotent) by disclosing plan-based staleness (Free 60 min, Basic 15, Pro none), snapshot semantics with cursor pinning and snapshot_expired, the meaning of historical_preview, the rule that only tickers with news in the window appear, that missing metrics are null-with-reason rather than neutral, and that scores are observed news, not forecasts or alerts. These are exactly the traits an agent cannot recover from 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.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose, return contents and defaults are front-loaded, and nearly every sentence carries operational weight (delays, null semantics, cursor rules). It is dense and somewhat run-on, with the event_context block reading as an appendix whose trigger is unclear, which costs it a point.

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?

For a 10-parameter, zero-required discovery tool with an output schema, the description covers freshness, pagination, null handling and filter composition thoroughly. The only real hole is the event_context discussion that is not anchored to any parameter, so the agent cannot tell whether it is always returned or opt-in.

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; the description still adds value by pairing parameters operationally ('sort=sentiment_change with order=asc', tickers intersect the selected scope with no alias expansion) rather than restating enums. One weakness: it discusses an event_context feature that does not correspond to any of the ten declared parameters, leaving the agent unsure how to enable or suppress it.

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?

Opens with a specific verb and resource ('Rank news activity across the market or your saved AlphAI watchlist') and enumerates what comes back (story counts, model vs. market-adjusted expectations, tone, linked headlines). The ranking/discovery framing is distinguishable from search-oriented siblings like alphai_news_search, but it never explicitly contrasts itself with alphai_ticker_news or alphai_stories, so an agent must infer the boundary.

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 operating recipes: 'Use sentiment=negative or sort=sentiment_change with order=asc to find deteriorating news tone', the default 20-ticker/24h/highest-activity posture, exact-ticker semantics with no alias expansion, and the pagination rule (same filters and limit with next_cursor; restart after snapshot_expired). What is missing is explicit when-not-to-use guidance and routing to sibling tools beyond the one handoff to alphai_article.

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

All AlphAI tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.