What inputs does list_signal_inbox accept?

unread_only (boolean, optional, default false): When true, return only items where read_at IS NULL. include_dismissed (boolean, optional, default false): When true, also return items the caller previously dismissed. limit (integer, optional, default 20): Maximum number of inbox items to return (1–100). Defaults to 20. cursor (integer, optional): Pagination cursor — the `fired_at` of the last item on the previous page.

Which Valuein plans include list_signal_inbox?

Available on the free tier (token required) and on Pro and Institutional. Not point-in-time safe.

state

List Signal Inbox

list_signal_inbox

Benchmark and above

Newest-first listing of the caller's in-app inbox. Items are signal FIRES with a `dashboard` channel — written by the cron evaluator (or `test_signal`) — plus platform notifications written by the edge-gateway (agent run completions, morning briefs, skipped runs); use list_sig...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "list_signal_inbox",    arguments={})print(result)

Direct tool call:list_signal_inbox(...)

Inputs

Parameter	Type	Required	Description
`unread_only`	boolean	optional	When true, return only items where read_at IS NULL.Default: `false`
`include_dismissed`	boolean	optional	When true, also return items the caller previously dismissed.Default: `false`
`limit`	integer	optional	Maximum number of inbox items to return (1–100). Defaults to 20.Default: `20`
`cursor`	integer	optional	Pagination cursor — the `fired_at` of the last item on the previous page.

Output Fields

itemsnext_cursorunread_count

Paging

Pass the next_cursor of one result as cursor on the next call, with the same other arguments. A null next_cursor is the last page.

Errors and paging for every tool: the agent contract.

Example Response

Illustrative

response.jsonjson

{  "items": null,  "next_cursor": null,  "unread_count": null}

Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.

Notes

Available from the Benchmark plan and above.

Try this tool

Get token All tools

Categorystate

PIT-safeNo

Min planBenchmark

Inputs4 (0 required)

Plan Access

Sample (guest)

Not included

Benchmark (token)

Available

Pro

Available

Institutional

Available

Related Tools

search_companies

Search Companies

get_company_fundamentals

Company Fundamentals

get_valuation_metrics

Valuation Metrics

get_financial_ratios

Financial Ratios

Resources

Point-in-Time methodology →Parquet schema reference →Bulk Data API reference →Python SDK guide →