Search Published Reports
search_reportsSearch the catalog of published research reports. All listings are free to read. Filters: free-text (matches title + abstract), ticker, report_type. Sort: `newest` (default) or `oldest`. Tier-gated: callers only see reports their plan tier can read.
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( "search_reports", arguments={})print(result)Direct tool call:search_reports(...)
Try it now
Paste this in your terminal — the free tier returns real sample data without authentication.
# No auth required — the Sample tier covers a large-cap US benchmark universe with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search_reports", "arguments": { "limit": 3 } } }'Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | optional | Free-text query over title + abstract (case-insensitive). |
ticker | string | optional | Filter to a single subject ticker. |
report_type | "reverse_dcf" | optional | Filter by report type. |
price_max_cents | integer | optional | Reserved for future paid listings; currently ignored (all reports are free). |
sort | "newest" | "oldest" | optional | —Default: "newest" |
limit | integer | optional | —Default: 20 |
cursor | string | optional | — |
Output Fields
reportsnext_cursorPaging
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
{ "reports": null, "next_cursor": 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 Sample plan and above.
Plan Access
Related Tools
Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.