Valuein
Discovery

List Agent Runs

list_agent_runs
Benchmark and above

List the caller's own standing-agent runs, newest first — status, goal, cost, and timing for each. A run may have been kicked off by this same agent (e.g. via create_rule's run_team action, a schedule_task wake, or run_agent) OR by the customer's own Workspace UI; this tool le...

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_agent_runs",    arguments={})print(result)

Direct tool call:list_agent_runs(...)

Inputs

ParameterTypeRequiredDescription
limitintegeroptionalMax runs to return (1-50, default 10).
statusstringoptionalFilter to an exact status match.
agent_idstringoptionalFilter to runs belonging to one agent (from save_agent/list_agents).

Output Fields

runs

Example Response

Illustrative
response.jsonjson
{  "runs": 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 tokenAll tools
CategoryDiscovery
PIT-safeNo
Min planBenchmark
Inputs3 (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 →

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