Stockfacts

Data coverage and freshness

get_data_coverage

Read-onlyIdempotent

What data Livermore has and how fresh it is: the Form 4 filing-date range, the 13F quarters loaded (with the number of filers), the latest complete 13F quarter, the number of curated superinvestors, the Schedule 13D, 13G and Form 144 filing-date ranges, the filing-date range of politicians' trade reports (the congress field: reports by members of the U.S. Congress), the date ranges of company filings (10-K, 10-Q, 8-K), FINRA short interest, daily short volume, weekly ATS volume and SEC fails-to-deliver, the number of companies with financial statements, and the number of companies with a market cap with the newest close date used (market_caps); each of these is null until loaded and has its own last_updated. taiwan covers the Taiwan stock data of the tw_ tools: the latest date of each daily table, the latest month of revenue and quarter of financial statements with the number of companies, how many companies have AI-written profiles and production sites, and where each dataset starts. Also the last successful data updates (ISO 8601 UTC), the update schedule and the usage limits of this server. Call it to check whether a date or quarter is covered.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Output Schema

TableJSON Schema

Name	Required	Description
`f13`	Yes
`form4`	Yes
`limits`	Yes
`taiwan`	Yes	Taiwan stocks (the tw_ tools); null until loaded.
`filings`	Yes
`sources`	Yes
`website`	Yes
`congress`	Yes
`docs_url`	Yes
`ownership`	Yes
`ats_weekly`	Yes
`financials`	Yes
`market_caps`	Yes
`llms_txt_url`	Yes
`short_volume`	Yes
`short_interest`	Yes
`superinvestors`	Yes
`update_schedule`	Yes
`fails_to_deliver`	Yes
`last_successful_update`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 19, 2026

addedOutput schema / properties / taiwan

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "companies_with_ai_profile": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "companies_with_production_sites": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "financials": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "companies": {
+                  "type": "number"
+                },
+                "latest_quarter": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "latest_quarter",
+                "companies"
+              ],
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The latest quarter (2026-q2 form) and how many companies have statements for it so far (MOPS covers every public company, including emerging-market ones the tw_ tools do not list)."
+        },
+        "history": {
+          "additionalProperties": false,
+          "properties": {
+            "daily_trading_since": {
+              "type": "string"
+            },
+            "dividends_since": {
+              "type": "string"
+            },
+            "financials_since": {
+              "type": "string"
+            },
+            "monthly_revenue_since": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "daily_trading_since",
+            "monthly_revenue_since",
+            "financials_since",
+            "dividends_since"
+          ],
+          "type": "object"
+        },
+        "latest_dates": {
+          "additionalProperties": false,
+          "description": "The latest trading day loaded in each daily table.",
+          "properties": {
+            "foreign_holding": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "institutional": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "margin": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "quotes": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "quotes",
+            "institutional",
+            "margin",
+            "foreign_holding"
+          ],
+          "type": "object"
+        },
+        "monthly_revenue": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "companies": {
+                  "type": "number"
+                },
+                "latest_month": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "latest_month",
+                "companies"
+              ],
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The latest month (YYYY-MM) and how many companies have reported it so far."
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "latest_dates",
+        "monthly_revenue",
+        "financials",
+        "companies_with_ai_profile",
+        "companies_with_production_sites",
+        "history",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Taiwan stocks (the tw_ tools); null until loaded."
+}

changedOutput schema / required

Previous value: -[
-  "website",
-  "sources",
-  "form4",
-  "f13",
-  "superinvestors",
-  "ownership",
-  "congress",
-  "filings",
-  "financials",
-  "short_interest",
-  "short_volume",
-  "ats_weekly",
-  "fails_to_deliver",
-  "market_caps",
-  "last_successful_update",
-  "update_schedule",
-  "limits",
-  "docs_url",
-  "llms_txt_url"
-]New value: +[
+  "website",
+  "sources",
+  "form4",
+  "f13",
+  "superinvestors",
+  "ownership",
+  "congress",
+  "filings",
+  "financials",
+  "short_interest",
+  "short_volume",
+  "ats_weekly",
+  "fails_to_deliver",
+  "market_caps",
+  "last_successful_update",
+  "taiwan",
+  "update_schedule",
+  "limits",
+  "docs_url",
+  "llms_txt_url"
+]

Changed4 schema fields changedOct 11, 2026

addedOutput schema / properties / last_successful_update / properties / market_caps
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

changedOutput schema / properties / last_successful_update / required

Previous value: -[
-  "sec_filings",
-  "tickers",
-  "cusip_mapping",
-  "congress",
-  "company_filings",
-  "financials",
-  "finra",
-  "exchange_rates"
-]New value: +[
+  "sec_filings",
+  "tickers",
+  "cusip_mapping",
+  "congress",
+  "company_filings",
+  "financials",
+  "finra",
+  "exchange_rates",
+  "market_caps"
+]

addedOutput schema / properties / market_caps

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "companies_with_market_cap": {
+          "type": "number"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_close_date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "companies_with_market_cap",
+        "latest_close_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / required

Previous value: -[
-  "website",
-  "sources",
-  "form4",
-  "f13",
-  "superinvestors",
-  "ownership",
-  "congress",
-  "filings",
-  "financials",
-  "short_interest",
-  "short_volume",
-  "ats_weekly",
-  "fails_to_deliver",
-  "last_successful_update",
-  "update_schedule",
-  "limits",
-  "docs_url",
-  "llms_txt_url"
-]New value: +[
+  "website",
+  "sources",
+  "form4",
+  "f13",
+  "superinvestors",
+  "ownership",
+  "congress",
+  "filings",
+  "financials",
+  "short_interest",
+  "short_volume",
+  "ats_weekly",
+  "fails_to_deliver",
+  "market_caps",
+  "last_successful_update",
+  "update_schedule",
+  "limits",
+  "docs_url",
+  "llms_txt_url"
+]

Changed12 schema fields changedOct 8, 2026

addedOutput schema / properties / ats_weekly

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "earliest_week_start": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_week_start": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "earliest_week_start",
+        "latest_week_start",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / fails_to_deliver

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "earliest_settlement_date": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_settlement_date": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "earliest_settlement_date",
+        "latest_settlement_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / filings

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "earliest_filed_date": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_filed_date": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "earliest_filed_date",
+        "latest_filed_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / financials

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "companies": {
+          "type": "number"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_filed_date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "companies",
+        "latest_filed_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / last_successful_update / properties / company_filings
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / last_successful_update / properties / exchange_rates
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / last_successful_update / properties / financials
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / last_successful_update / properties / finra
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

changedOutput schema / properties / last_successful_update / required

Previous value: -[
-  "sec_filings",
-  "tickers",
-  "cusip_mapping",
-  "congress"
-]New value: +[
+  "sec_filings",
+  "tickers",
+  "cusip_mapping",
+  "congress",
+  "company_filings",
+  "financials",
+  "finra",
+  "exchange_rates"
+]

addedOutput schema / properties / short_interest

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "earliest_settlement_date": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_settlement_date": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "earliest_settlement_date",
+        "latest_settlement_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / short_volume

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "earliest_trade_date": {
+          "type": "string"
+        },
+        "last_updated": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "latest_trade_date": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "earliest_trade_date",
+        "latest_trade_date",
+        "last_updated",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / required

Previous value: -[
-  "website",
-  "sources",
-  "form4",
-  "f13",
-  "superinvestors",
-  "ownership",
-  "congress",
-  "last_successful_update",
-  "update_schedule",
-  "limits",
-  "docs_url",
-  "llms_txt_url"
-]New value: +[
+  "website",
+  "sources",
+  "form4",
+  "f13",
+  "superinvestors",
+  "ownership",
+  "congress",
+  "filings",
+  "financials",
+  "short_interest",
+  "short_volume",
+  "ats_weekly",
+  "fails_to_deliver",
+  "last_successful_update",
+  "update_schedule",
+  "limits",
+  "docs_url",
+  "llms_txt_url"
+]

Changed6 schema fields changedSep 27, 2026

addedOutput schema / properties / congress

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "earliest_filed_date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "latest_filed_date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "note": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "earliest_filed_date",
+    "latest_filed_date",
+    "note"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / last_successful_update / properties / congress
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

changedOutput schema / properties / last_successful_update / required

Previous value: -[
-  "sec_filings",
-  "tickers",
-  "cusip_mapping"
-]New value: +[
+  "sec_filings",
+  "tickers",
+  "cusip_mapping",
+  "congress"
+]

removedOutput schema / properties / not_yet_available

Removed value: -{
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

addedOutput schema / properties / ownership

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "form144": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "earliest_filed_date": {
+              "type": "string"
+            },
+            "latest_filed_at": {
+              "type": "string"
+            },
+            "latest_filed_date": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "earliest_filed_date",
+            "latest_filed_at",
+            "latest_filed_date"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "note": {
+      "type": "string"
+    },
+    "schedule_13d": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "earliest_filed_date": {
+              "type": "string"
+            },
+            "latest_filed_at": {
+              "type": "string"
+            },
+            "latest_filed_date": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "earliest_filed_date",
+            "latest_filed_at",
+            "latest_filed_date"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "schedule_13g": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "earliest_filed_date": {
+              "type": "string"
+            },
+            "latest_filed_at": {
+              "type": "string"
+            },
+            "latest_filed_date": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "earliest_filed_date",
+            "latest_filed_at",
+            "latest_filed_date"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "schedule_13d",
+    "schedule_13g",
+    "form144",
+    "note"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "website",
-  "sources",
-  "form4",
-  "f13",
-  "superinvestors",
-  "last_successful_update",
-  "update_schedule",
-  "not_yet_available",
-  "limits",
-  "docs_url",
-  "llms_txt_url"
-]New value: +[
+  "website",
+  "sources",
+  "form4",
+  "f13",
+  "superinvestors",
+  "ownership",
+  "congress",
+  "last_successful_update",
+  "update_schedule",
+  "limits",
+  "docs_url",
+  "llms_txt_url"
+]

First observedSep 27, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive, so safety is covered. The description adds real behavioral context beyond that: fields are null until loaded, each has its own last_updated, and it also reports last successful update timestamps, update schedule, and server usage limits. It omits nothing risky, though it doesn't hint at response size given the breadth of the payload.

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

Conciseness2/5

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

A single ~250-word run-on sentence buries the actionable guidance ("Call it to check whether a date or quarter is covered") at the very end. The catalogue of datasets is defensible for an exhaustive coverage tool, but it is unstructured prose with no grouping or bullets, and a reader must wade through every dataset name to reach the point.

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

Completeness4/5

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

For a zero-parameter tool with an output schema, coverage is high: the description tells the agent what categories of coverage exist and that missing datasets appear as null. It is arguably redundant with the output schema in enumerating fields, and it could say more about what the agent should do with the answer, but nothing needed to call it is missing.

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?

There are zero input parameters, so per the rubric the baseline is 4. The description spends its words on output contents rather than inputs, which is harmless here since there is nothing to pass.

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 description states unambiguously what the tool returns: an inventory of which datasets exist (Form 4, 13F, 13D/13G, Form 144, congress trades, 10-K/10-Q/8-K, FINRA short interest, ATS, fails-to-deliver, market_caps, Taiwan/tw_ datasets) and their freshness. Among data-returning siblings like get_financials or get_insider_trades, it is clearly the metadata/coverage tool rather than a data-fetch tool, so the agent can separate it without inspecting schemas.

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?

The closing line gives explicit context: "Call it to check whether a date or quarter is covered." That is a clear trigger condition. It does not name alternatives or state when NOT to call it (e.g. that it returns no actual filing data and must be followed by the relevant get_/list_ tool), so it stops short of full when/when-not guidance.

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

All Stockfacts 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.

Resources

Need Help?