What inputs does get_earnings_signals accept?

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.

Which Valuein plans include get_earnings_signals?

Available on: sample, sp500, full. Point-in-time safe via as_of_date filtering.

Signals

PIT-safe

Earnings Signals

get_earnings_signals

sample

sp500

full

Reported earnings results and earnings-surprise metrics for a company, by fiscal period: actual EPS, an expected-EPS estimate, the surprise versus that estimate (as a %), reported revenue, and year-over-year revenue growth. Use it to see whether a company beat or missed on earnings 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

No token required

Paste this in your terminal — the sample 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_pct

Example 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
  }
]