Get Compute-Ready Stream

get_compute_ready_stream

sample

sp500

full

Returns a presigned R2 URL for direct bulk Parquet access. Use for loading full tables into DuckDB, Spark, or Pandas without going through the REST API. Presigned URLs expire in 1 hour. Supports all 8 tables.

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(
    "get_compute_ready_stream",
    arguments={
    "table": "EXAMPLE"
}
)
print(result)

Direct tool call:get_compute_ready_stream(table="fact")

Inputs

Parameter	Type	Required	Description
`table`	string	required	Table name: entity, security, filing, fact, valuation, taxonomy_guide, index_membership, references
`format`	string	optional	Output format: parquet (default) or wide_parquet for pre-pivoted wide tables.

Output Fields

urlexpires_attableplanestimated_size_mb

Example Response

{
  "url": "https://r2.valuein.biz/signed/fact.parquet?token=...",
  "expires_at": "2024-03-15",
  "table": "fact",
  "plan": "sp500",
  "estimated_size_mb": 342
}

Returns a presigned URL for fact.parquet — load directly with pd.read_parquet(url) or duckdb.read_parquet(url).

Notes

URL expires in 60 minutes. The fact table is large (several GB on full plan) — use DuckDB's lazy reading with filters rather than loading the full table into memory.