Earnings Signals
get_earnings_signalsReported earnings results and earnings-surprise metrics for a company, by fiscal period: actual EPS, the expected EPS we publish, the surprise versus expected (as a %), reported revenue, and year-over-year revenue growth. Use it to see whether a company beat or missed and by how much, and to track revenue trajectory. Point-in-time safe — pass as_of_date to filter by SEC acceptance (accepted_at) for look-ahead-free backtests. Available on all plans.
Example Call
# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool( "get_earnings_signals", arguments={ "ticker": "EXAMPLE"})print(result)Direct tool call:get_earnings_signals(ticker="TSLA", as_of_date="2024-01-01")
Try it now
Paste this in your terminal — the free tier returns real S&P500 data without authentication.
# No auth required — sample tier covers S&P500 with a 5-year window.# Add an Authorization: Bearer header for full universe and history.$ curl -X POST https://mcp.valuein.biz/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_earnings_signals", "arguments": { "ticker": "AAPL" } } }'Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
ticker | string | required | Ticker symbol |
as_of_date | string | optional | YYYY-MM-DD PIT filter. Only returns signals with accepted_at on or before this date. |
Output Fields
entity_idperiod_endfiscal_yearfiscal_periodaccepted_ateps_actualeps_trend_esteps_surprise_pctrevenue_actualrevenue_yoy_pctExample Response
[ { "entity_id": "0000320193", "period_end": "2024-03-15", "fiscal_year": 2024, "fiscal_period": "FY", "accepted_at": "2024-03-15", "eps_actual": null, "eps_trend_est": null, "eps_surprise_pct": null }]Shape only — field names match the live schema; values are placeholders, not real filings. Returns Tesla's quarterly reported EPS, expected EPS, and surprise % as of Jan 2024.
Notes
surprise_pct is NULL when the expected-EPS baseline is near zero (to avoid division instability) — filter IS NOT NULL for momentum screens.