Valuein
Discovery

List Claims

list_claims
Benchmark and above

List the caller's saved claims, most-recent-first, with AND-composed filters and cursor pagination. Filter by ticker, claim_type (assertion/prediction/judgment), tag, or lifecycle status (open/confirmed/refuted/expired/stale/needs_review). Archived claims are excluded unless i...

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

Direct tool call:list_claims(...)

Inputs

ParameterTypeRequiredDescription
tickerstringoptionalFilter to claims referencing this ticker.
claim_type"assertion" | "prediction" | "judgment"optionalFilter by epistemic type.
tag"financial" | "valuation" | "operational" | "competitive" | "structural" | "strategic" | "macro" | "behavioral" | "catalyst" | "risk" | "trend" | "comparison" | "causation" | "liquidity" | "governance" | "guidance"optionalFilter to claims carrying this topical tag.
status"open" | "confirmed" | "refuted" | "expired" | "stale" | "needs_review" | "all"optionalFilter by lifecycle status, or 'all'.Default: "all"
include_archivedbooleanoptionalInclude soft-deleted claims.Default: false
limitintegeroptionalPage size (max 100).Default: 25
cursorstringoptionalPagination cursor from a previous page's next_cursor.

Output Fields

claimsnext_cursortotal_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
{  "claims": null,  "next_cursor": null,  "total_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 tokenAll tools
CategoryDiscovery
PIT-safeNo
Min planBenchmark
Inputs7 (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.