What inputs does render_report accept?

report_id (string, required): Id from create_report or list_my_reports. format ("md" | "docx" | "pdf", required): md = raw markdown (the same body the editor renders). docx = branded Word document; pdf = the same branded research-note design as a shareable PDF (Geist faces embedded, clickable citation links). force_regenerate (boolean, optional, default false): If true, ignore the cached DOCX/PDF and re-render. No effect on md (markdown is canonical). author_name (string, optional): Display name of the report's author, shown as a named byline ('By {name}') on the masthead — the way a real research note credits an analyst. Omit to show 'Valuein Research'. Only affects the binary formats; ignored on a cache hit (the cached file keeps whatever byline was baked in on first render — pass `force_regenerate: true` to refresh it).

Which Valuein plans include render_report?

Available on every plan, including the free tier with no account. Not point-in-time safe.

reports

Render Report Download URL

render_report

Sample and above

Return a 15-minute presigned download URL for a report in the requested binary format. `format=md` presigns the cached markdown — instant, no compute. `format=docx` and `format=pdf` return the SAME branded research-note design in the two media: a masthead-first page 1 (Valuein...

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(    "render_report",    arguments={    "report_id": "EXAMPLE",    "format": "md"})print(result)

Direct tool call:render_report(...)

Inputs

Parameter	Type	Required	Description
`report_id`	string	required	Id from create_report or list_my_reports.
`format`	"md" \| "docx" \| "pdf"	required	md = raw markdown (the same body the editor renders). docx = branded Word document; pdf = the same branded research-note design as a shareable PDF (Geist faces embedded, clickable citation links).
`force_regenerate`	boolean	optional	If true, ignore the cached DOCX/PDF and re-render. No effect on md (markdown is canonical).Default: `false`
`author_name`	string	optional	Display name of the report's author, shown as a named byline ('By {name}') on the masthead — the way a real research note credits an analyst. Omit to show 'Valuein Research'. Only affects the binary formats; ignored on a cache hit (the cached file keeps whatever byline was baked in on first render — pass `force_regenerate: true` to refresh it).

Output Fields

urlformatfilenamecontent_typesize_bytesexpires_in_secondsexpires_atfrom_cache

Example Response

Illustrative

response.jsonjson

{  "url": "https://r2.valuein.biz/signed/fact.parquet?token=...",  "format": null,  "filename": null,  "content_type": null,  "size_bytes": null,  "expires_in_seconds": null,  "expires_at": "2024-03-15",  "from_cache": null}