What inputs does stage_action accept?

tool_name (string, required): The MCP tool this action would call once approved (e.g. 'save_thesis', 'create_signal', 'publish_report'). tool_args (object, optional, default {}): The exact arguments to replay through that tool if/when a human approves. origin (string, required): Free-form label identifying who/what is proposing this action — e.g. 'agent-runner:managed', 'claude-connector', 'cursor', or any caller-supplied identifier. Lets a human distinguish which session/agent proposed a given write.

Which Valuein plans include stage_action?

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

Discovery

Stage Action

stage_action

Benchmark and above

Propose an MCP tool call for human approval BEFORE running it. Call this — instead of calling the tool directly — whenever an autonomous or unattended caller (a scheduled standing agent, an unattended agent-runner run, or any MCP client operating without a human watching) is a...

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(    "stage_action",    arguments={    "tool_name": "EXAMPLE",    "origin": "EXAMPLE"})print(result)

Direct tool call:stage_action(...)

Inputs

Parameter	Type	Required	Description
`tool_name`	string	required	The MCP tool this action would call once approved (e.g. 'save_thesis', 'create_signal', 'publish_report').
`tool_args`	object	optional	The exact arguments to replay through that tool if/when a human approves.Default: `{}`
`origin`	string	required	Free-form label identifying who/what is proposing this action — e.g. 'agent-runner:managed', 'claude-connector', 'cursor', or any caller-supplied identifier. Lets a human distinguish which session/agent proposed a given write.

Output Fields

resultrisk_tierstaged_action_idstaged_action

Example Response

Illustrative

response.jsonjson

{  "result": null,  "risk_tier": null,  "staged_action_id": null,  "staged_action": 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

CategoryDiscovery

PIT-safeNo

Min planBenchmark

Inputs3 (2 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 →

Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.