What inputs does describe_schema accept?

table (string, optional): Filter to a single table name (e.g. 'fact', 'entity', 'references'). Omit to return the full schema for all tables.

Which Valuein plans include describe_schema?

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

Discovery

Describe Data Schema

describe_schema

Sample and above

Returns the Parquet schema for all tables in the Valuein SEC data warehouse. Includes table descriptions, column names, types, primary keys, and foreign-key references. Use this tool to understand the data model before querying with other tools. No data reads required — schema...

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

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

Try it now

No token required

Paste this in your terminal — the free tier returns real S&P500 data without authentication.

try-it.shbash

# No auth required — the Sample tier covers S&P 500 constituents 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": "describe_schema",          "arguments": {}        }      }'

Inputs

Parameter	Type	Required	Description
`table`	string	optional	Filter to a single table name (e.g. 'fact', 'entity', 'references'). Omit to return the full schema for all tables.

Output Fields

tablescolumnstypesprimary_keysforeign_keysdescription

Example Response

Illustrative

response.jsonjson

{  "tables": null,  "columns": null,  "types": null,  "primary_keys": null,  "foreign_keys": null,  "description": null}

Shape only — field names match the live schema; values are placeholders, not real filings. Returns the column definitions and types for the fact table.