Zentrix MCP tool reference
The Zentrix MCP server exposes live stock market data, news, sentiment, alerts, and portfolio tools to any MCP-compatible AI assistant. Every tool below is grouped by category, with its parameters.
Authentication
Most tools operate on the authenticated user's account (watchlist, holdings, alerts, usage). A few are public and require no authentication: watchlist_default_get and market_status.
Watchlist
| Tool | Description | Key parameters |
|---|---|---|
| watchlist_get | Current watchlist with live prices, day-change %, and market state. | None |
| watchlist_add | Add a ticker to the watchlist. | ticker |
| watchlist_recap | One-shot gainers/losers/news summary across the watchlist. | None |
| watchlist_default_get | Live snapshot of a curated public watchlist (e.g. "Big Tech", "AI Stocks"). | name |
watchlist_recap combines price data with news but excludes sentiment scores by default. Call sentiment_for_ticker separately if needed.
Portfolio
| Tool | Description | Key parameters |
|---|---|---|
| portfolio_analysis | Value-weighted position and sector exposure on user-entered holdings; reports missing or stale price data explicitly. | None |
This tool never infers suitability or presents output as a trade recommendation. It's exposure reporting only.
Market Data
| Tool | Description | Key parameters |
|---|---|---|
| stock_search | Resolve a ticker or company name fragment to matching symbols. | query |
| stock_chart_summary | Price/volume chart data plus key metrics (open, day range, 52-week range, market cap, EPS, P/E) and a plain-English trend summary. | symbol, timeframe (1D/5D/1M/6M/YTD/1Y/5Y/MAX) |
| market_status | Whether the US market is currently open. | None |
News & Sentiment
| Tool | Description | Key parameters |
|---|---|---|
| news_web_search | Live web-sourced headlines (6-8 most recent) with source, recency, and per-item bullish/neutral/bearish tag. | ticker |
| news_for_ticker | Structured article feed (up to 25) plus a live web-analysis summary, combined in one response. | ticker, limit (default 10) |
| sentiment_for_ticker | Aggregate 0-100 sentiment score with a short AI-generated summary; cached 24h per ticker. | ticker |
news_web_search is always live; sentiment_for_ticker is a cached aggregate. Use accordingly depending on whether the caller needs freshness or a single summarized score.
Alerts
| Tool | Description | Key parameters |
|---|---|---|
| alert_set | Set a one-shot price alert (email on trigger). | ticker, conditionType (price_below/price_above), thresholdPrice |
| alert_list | List alerts grouped by active / triggered / paused. | None |
| alert_update | Change an existing alert's threshold/direction and re-arm it. | alertId, ... |
| alert_pause | Pause an active alert. | alertId |
| alert_resume | Re-arm a triggered or paused alert. | alertId |
| alert_cancel | Cancel a single alert. | alertId |
| alert_cancel_all | Cancel all active alerts. | None |
Alerts auto-pause after triggering (no repeat notifications). Only active alerts count toward the per-user alert limit; if the limit is reached, alert_set returns the active list so one can be paused to make room.
Earnings
| Tool | Description | Key parameters |
|---|---|---|
| earnings_calendar | Market-wide upcoming earnings dates: company, fiscal quarter, BMO/AMC timing, EPS estimate/actual. | tickers (optional filter), daysAhead (default 14, max 90) |
Refreshed nightly from a bulk earnings provider; served instantly from the Zentrix database.
Account & Usage
| Tool | Description | Key parameters |
|---|---|---|
| usage_status | Current daily API usage: calls used/remaining, tier, reset time. | None |
Returns a low-balance warning when 3 or fewer calls remain for the day.
Scope notes
- Zentrix is a data and insight layer: quotes, charts, news, sentiment, alerts, earnings, and portfolio exposure reporting.
- It does not place trades or manage brokerage execution. It's designed to sit alongside, not replace, an execution-capable service.
- Data freshness varies by tool: prices and market status are live, sentiment is cached 24h, and earnings data refreshes nightly.