MCP tools: Markets & prices

​

get_market_data

• API endpoints: GET /api/market/v1/get-fear-greed-index, GET /api/market/v1/get-physical-divergence-index, GET /api/market/v1/get-physical-premiums, GET /api/market/v1/get-sector-summary, GET /api/market/v1/list-commodity-quotes, GET /api/market/v1/list-crypto-quotes, GET /api/market/v1/list-etf-flows, GET /api/market/v1/list-gulf-quotes, GET /api/market/v1/list-market-quotes
• Access: free-account — callable by any signed-in account; free accounts spend the daily free allowance, Pro calls spend the daily quota. Accepts the universal summary argument.
• Paid panel accounting: Pro and Pro Business spend one allocation for the initial market panel. Subsequent curated filters and repeated opens reuse that admission within its five-minute window. The result’s panelRequest.token can be passed as panel_request for authorized reads until expiry. A new refresh UUID spends one new allocation. API plans retain weighted per-tool billing. Free-account calls retain their daily free allowance.
• Source scope: filters select already-seeded quotes. Neither a receipt nor refresh fetches an arbitrary symbol, an account watchlist, or new provider data. Unavailable or stale results remain eligible for retry under the same valid receipt. An upstream failure does not refund the initial allocation.
• Physical datasets are subscription-only: physical-premium and physical-divergence carry the same data as the Pro-only (tier 1) REST routes — see Pro Intelligence Suite. A signed-in free account gets the quotes, sectors, ETF flows and Fear & Greed index but not these two: they are never read for it, they are absent from data, and the response names them in locked beside an upgradeUrl. Read locked as “not on your plan”, not as “no data”. Before this change the bundle served both to free accounts as a deliberate exception from #7433; the exception is closed.
• Kind: cache read — sub-second response from Redis bootstrap cache.
• Freshness budget: the stale flag tracks the market and sector snapshots only (30 min each). The daily physicalPremiums and physicalDivergence datasets are monitored on /api/health instead. Read their timestamps and the divergence state when age matters. The divergence method is documented in Physical Precious-Metals Divergence Index.
• Sector valuationCoverage separates write age (stale) from completeness (sourceStatus: ok, partial, or degraded). stale describes the seed write, not the individual records — a freshly written payload can still contain older valuations. valuationCount and expectedValuationCount follow a symbols filter when one is supplied. valuationCount counts live and replayed records together; currentValuationCount gives the subset actually fetched this cycle and is omitted when every record is current. staleValuationSymbols lists symbols served from an older snapshot — those symbols do have values in valuations, and lastGood.fetchedAt gives their age (bounded by a 7-day snapshot TTL). unavailableSymbols lists symbols with no valuation published at all, and is disjoint from staleValuationSymbols. lastGood covers both whole records and borrowed return metrics, and includes that snapshot’s timestamp. sourceStatus is degraded when no record is current, partial when some are stale or missing. valuationDiagnostics is bounded per-symbol route metadata across the v7Quote, v7QuoteBatch, and quoteSummary routes, showing independent direct/proxy outcomes, response classes, and missing fields; it never contains credentials.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_market_data","arguments":{}}
  }'

​

get_gold_intelligence

• API endpoint: GET /api/market/v1/get-gold-intelligence.
• Access: subscription. One signed downstream GET uses the standard API allowance weight of 2; a dedicated MCP allowance charges one call. Billing denial and retry/backoff contracts remain active.
• Output budget: 128 KiB. The tool is read-only and does not create a trade or research snapshot.

​

get_stock_research

• API endpoints: GET /api/market/v1/analyze-stock, GET /api/market/v1/backtest-stock, GET /api/market/v1/get-stock-analysis-history, GET /api/market/v1/list-stored-stock-backtests.
• Access: subscription. Existing MCP metering, gateway subscription checks, provider quotas, billing denial and retry/backoff contracts remain active. Cold analysis may take longer than seeded reads. The tool may save shared snapshots, so its read-only and idempotent hints are false; its destructive hint is false.
• Output budget: 512 KiB. For a large watchlist use fewer symbols/snapshots or jmespath to select the fields needed. A budget-exceeded envelope is not complete history.

​

get_company_intelligence

• API endpoints: GET /api/intelligence/v1/get-company-enrichment, GET /api/intelligence/v1/list-company-signals, GET /api/intelligence/v1/search-sec-filings, GET /api/intelligence/v1/list-material-events
• Access: subscription — requires a Pro subscription. RPC tool: no summary argument (use jmespath to trim the response).
• Kind: canonical-route proxy — enrichment fans out to SEC submissions, Finnhub profile + earnings surprises, and news mentions; signals uses timestamped SEC filings + news (not fiscal period ends). Each upstream is independently cached. filings-search proxies EDGAR full-text search; material-events reads the seeded market-wide 8-K stream (30-minute cadence).
• Freshness: every view’s payload carries its own timestamp (enrichedAtMs, discoveredAtMs, fetchedAtMs); material-events.fetchedAtMs is the seed time of the stream snapshot.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_company_intelligence","arguments":{"ticker":"AAPL","view":"signals"}}
  }'

​

get_prediction_markets

• Price moves: Optional change24h and change7d are percentage-point changes on the yesPrice 0–100 scale. Missing upstream values are absent; zero means no change. Kalshi supplies only 24h changes. REST returns yesPriceChange24h and yesPriceChange7d on the 0–1 probability scale.
• Liquidity: Optional liquidity is resting order-book depth in USD, measured per venue. Polymarket records use Gamma’s CLOB liquidity (liquidity, equal to liquidityClob): event-level on bucket records, contract-level on country records. Kalshi records sum price times size over every yes and no bid in the contract’s order book. The venues compute depth differently, so compare thresholds within one source. The field is absent when the venue reports nothing or the order book could not be fetched. REST accepts the same filter as min_liquidity.
• API endpoints: GET /api/prediction/v1/list-prediction-markets
• Access: free-account. Any signed-in account can call this tool. Free accounts spend their daily free allowance. API plans retain weighted per-tool billing. Accepts the universal summary argument.
• Paid panel accounting: Pro and Pro Business spend one allocation for an opening. Canonical filters and repeated opens share the prediction admission within five minutes. The returned panelRequest.token authorizes curated prediction reads until expiry. Local category expansion reads loaded data without another tool call. Each admission permits at most 64 uncached tool executions, with separate 64-per-minute uncached and cached-replay limits. Those executions are not individual Redis commands.
• Limits and refresh: The default limit is 30 per category. Zero or negative values apply no cap; positive fractions use the integer part. Default refresh: false reuses the prediction admission. Set refresh: true with a UUID request_id and omit panel_request to start a new allocation. Retries with the same UUID, including different letter case, reuse the allocation and its original expiry.
• Paid argument validation: Category and source trim whitespace and ignore letter case. Query matching ignores letter case and surrounding whitespace. Paid calls reject unknown arguments, invalid categories or sources, and non-finite or non-numeric limits before reservation. Ordinary API and free calls retain their existing filter coercion. Refresh controls and paid receipts are unavailable to API and free calls.
• Reuse and recovery: Identical canonical filters replay successful original results before summary or JMESPath projection. A new uncached filter reads the existing bootstrap and freshness metadata. A fresh, valid filtered-empty result can replay. Stale, unavailable, malformed, and unknown observations remain retryable under the receipt. Upstream failures do not refund the opening.
• Usage notices: An explicit authorized receipt read also reads the current daily allowance without reserving another unit. If the counter is unavailable or unconfirmed, contracts remain available without a numeric notice. A previous opening notice does not prove later accounting.
• Kind: cache read from the Redis bootstrap cache.
• Freshness budget: up to 1.5 h before stale: true is flagged (set by the seeder cron’s expected interval).
• Spoken mode: response_mode: "spoken" returns 2-3 sentences: contracts per bucket after your filters, then the leading market in the first two populated buckets (or the top two in one bucket) with yesPrice as a percentage and the 24-hour move in points. Citations carry venue, title and URL. Cannot be combined with summary.

curl -s https://worldmonitor.app/mcp \
  -H "X-WorldMonitor-Key: $WM_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{"name":"get_prediction_markets","arguments":{}}
  }'