Valuein — SEC EDGAR Fundamentals & Smart-Money Data

Render Report Download URL

render_report

Idempotent

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 letterhead — brand rule, wordmark, 'EQUITY RESEARCH' kicker + date), the ticker eyebrow and title, the named analyst's byline, then the body (abstract, sections with full markdown incl. GFM tables, citations table with clickable SEC EDGAR links) and a running footer (ticker, 'Built on Valuein · valuein.biz', page N of M, one disclosure line). The PDF embeds the Geist brand faces with figures set in tabular mono. Binary renders are cached in R2 after first build so repeat downloads are instant; pass force_regenerate: true to bust the cache (e.g. right after update_report).

Tier gate mirrors get_report: authors always see their own reports; non-authors below the report's required tier get an upgrade prompt.

Input Schema

Name	Required	Description
`format`	Yes	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).
`report_id`	Yes	Id from create_report or list_my_reports.
`author_name`	No	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).
`force_regenerate`	No	If true, ignore the cached DOCX/PDF and re-render. No effect on md (markdown is canonical).

Output Schema

Name	Required	Description
`url`	Yes
`_meta`	Yes	Provenance envelope — data lineage for every MCP response
`format`	Yes
`filename`	Yes
`expires_at`	Yes
`from_cache`	Yes
`size_bytes`	Yes
`content_type`	Yes
`expires_in_seconds`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 29, 2026

changedOutput schema / properties / _meta / properties / cost_usd / properties / basis / description

Previous value: -"payg_charge = real charge (agent-pay or your balance). payg_rate_card = indicative price, not billed."New value: +"payg_charge = real pay-per-call charge (a card or MPP payment through agent-pay). payg_rate_card = indicative price, not billed."

Changed2 schema fields changedOct 29, 2026

changedOutput schema / properties / _meta / properties / cost_usd / properties / basis / description

Previous value: -"payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed."New value: +"payg_charge = real charge (agent-pay or your balance). payg_rate_card = indicative price, not billed."

changedOutput schema / properties / _meta / properties / cost_usd / properties / billed / description

Previous value: -"true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free."New value: +"true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value only: no charge was made for this call (it was within your plan)."

AddedOct 16, 2026
RemovedSep 29, 2026

Changed1 schema field changedSep 18, 2026

changedOutput schema / properties / _meta / properties / fundamentals_as_of / description

Previous value: -"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt. Use THIS — not `last_updated` — when telling a user how current the fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to."New value: +"ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt in bulk. Use THIS — not `last_updated` — when telling a user how current the cross-sectional fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to. It is a floor for a single filer, not a ceiling: a filer with a live partition receives its filing, facts and ratios intraday (minutes after EDGAR dissemination), so an entity-scoped read may carry a filing newer than this; cross-sectional ranks (factor scores, earnings signals) refresh with the weekly bulk export."

Changed5 schema fields changedAug 5, 2026

changedInput schema / properties / author_name / description

Previous value: -"Display name of the report's author, shown as a named byline ('By {name}') on the docx masthead — the way a real research note credits an analyst. Omit to show just the date. Only affects `format=docx`; ignored on a cache hit (the cached file keeps whatever byline was baked in on first render — pass `force_regenerate: true` to refresh it)."New value: +"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)."

changedInput schema / properties / force_regenerate / description

Previous value: -"If true, ignore the cached DOCX and re-render. No effect on md (markdown is canonical)."New value: +"If true, ignore the cached DOCX/PDF and re-render. No effect on md (markdown is canonical)."

changedInput schema / properties / format / description

Previous value: -"md = raw markdown (the same body the editor renders). docx = branded Word document — cover page crediting the named analyst, masthead repeated on page 2, running footer."New value: +"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)."

changedInput schema / properties / format / enum

Previous value: -[
-  "md",
-  "docx"
-]New value: +[
+  "md",
+  "docx",
+  "pdf"
+]

changedOutput schema / properties / format / enum

Previous value: -[
-  "md",
-  "docx"
-]New value: +[
+  "md",
+  "docx",
+  "pdf"
+]

Changed2 schema fields changedJul 25, 2026

addedOutput schema / properties / _meta / properties / fundamentals_as_of

Added value: +{
+  "description": "ISO timestamp when the FINANCIAL STATEMENTS were last rebuilt. Use THIS — not `last_updated` — when telling a user how current the fundamentals are. The snapshot is republished on every weekday price refresh while the statements are carried forward unchanged, so `last_updated` can be far more recent than the numbers it sits next to.",
+  "type": "string"
+}

addedOutput schema / properties / _meta / properties / price_as_of

Added value: +{
+  "description": "ISO timestamp when the price surfaces were last refreshed.",
+  "type": "string"
+}

Changed1 schema field changedJul 8, 2026

changedInput schema / properties / format / description

Previous value: -"md = raw markdown (the same body the editor renders). docx = branded Word document — a compact masthead on page 1, no dedicated cover page, running footer."New value: +"md = raw markdown (the same body the editor renders). docx = branded Word document — cover page crediting the named analyst, masthead repeated on page 2, running footer."

Changed4 schema fields changedJul 7, 2026

addedInput schema / properties / author_name

Added value: +{
+  "description": "Display name of the report's author, shown as a named byline ('By {name}') on the docx masthead — the way a real research note credits an analyst. Omit to show just the date. Only affects `format=docx`; ignored on a cache hit (the cached file keeps whatever byline was baked in on first render — pass `force_regenerate: true` to refresh it).",
+  "maxLength": 120,
+  "type": "string"
+}

changedInput schema / properties / format / description

Previous value: -"md = raw markdown (the same body the editor renders). docx = branded Word document with cover + back page."New value: +"md = raw markdown (the same body the editor renders). docx = branded Word document — a compact masthead on page 1, no dedicated cover page, running footer."

addedOutput schema / properties / _meta / properties / cost_usd

Added value: +{
+  "additionalProperties": false,
+  "description": "Per-call cost transparency. Omitted for subscription-only tools that have no PAYG-equivalent price.",
+  "properties": {
+    "amount_usd": {
+      "minimum": 0,
+      "type": "number"
+    },
+    "basis": {
+      "description": "payg_charge = real agent-pay charge. payg_rate_card = indicative price, not billed.",
+      "enum": [
+        "payg_charge",
+        "payg_rate_card"
+      ],
+      "type": "string"
+    },
+    "billed": {
+      "description": "true = this amount was actually charged via PAYG for this call. false = indicative PAYG-equivalent value; your plan already covers this call for free.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "amount_usd",
+    "billed",
+    "basis"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / _meta / properties / latency_ms

Added value: +{
+  "description": "Wall-clock milliseconds this tool call took, measured server-side around the handler.",
+  "minimum": 0,
+  "type": "integer"
+}

Changed1 schema field changedJun 18, 2026
- addedOutput schema / properties / _meta / properties / pit_safe / description
```
Added value: +"true iff a zero-look-ahead point-in-time cut was applied to every returned figure"
```
AddedMay 19, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations by disclosing the 15-minute URL expiry, the R2 caching lifecycle, the cost profile (instant for md, compute only on first binary build), and a genuinely non-obvious staleness rule: `author_name` is ignored on a cache hit because the byline is baked into the file. It also states the authorization model (authors see their own reports; below-tier non-authors get an upgrade prompt), which the annotations do not cover.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in sentence one, and the format/cache/access information follows in a logical order. The middle paragraph spends considerable text on masthead design details (wordmark, kicker, byline, footer strings, Geist faces) that matter less for tool selection than for output prediction, though they do justify the docx-vs-pdf distinction.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description need not explain return values, and it covers everything else an agent needs: format trade-offs, cache-busting, byline persistence quirks, and the access/tier gate. Nothing about invoking this tool correctly is left ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, so the baseline is 3. The description adds real semantic value beyond it by contrasting what docx and pdf actually are ('the SAME branded research-note design in the two media') and by characterising md as instant with no compute, which helps an agent pick a format. It largely restates the schema's per-parameter text rather than extending it, keeping it below a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence states a specific verb, resource and return type: 'Return a 15-minute presigned download URL for a report in the requested binary format.' It also distinguishes itself from content-reading siblings implicitly by making clear the output is a download URL, not the report body, and names file formats explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear when-to guidance on individual options: `format=md` for instant cached markdown with no compute, `force_regenerate: true` 'e.g. right after `update_report`'. The tier-gate note ('mirrors `get_report`') explains the access case. What's missing is an explicit statement of when to prefer this over `get_report`/`get_report_version` for reading content, which is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Valuein — SEC EDGAR Fundamentals & Smart-Money Data tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Render Report Download URL

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources