{"endpoint":"https://beanvest.com/api/mcp","transport":"Streamable HTTP","protocolVersions":["2025-11-25","2025-06-18","2025-03-26"],"authentication":"none; public read-only data","tools":[{"name":"search_companies","title":"Search companies","description":"Find supported companies by name, ticker or share-class alias. Returns canonical symbols, available pages, reporting currency and dated USD market caps; no private favorites.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":120,"default":""},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_company_page","title":"Read a financial page","description":"Read the same sourced values and formulas as a financial page: revenue, valuation, cash flow, margins, returns, capital, Tesla deliveries, Optimus disclosures, Moat or Fair Value. Research pages expose versioned analysis and do not accept chart filters. Fair Value retains Premium access except free example companies. Null is unavailable. Pagination is newest-first; statistics cover the full selected range. Read rawDataPath for complete filing evidence.","inputSchema":{"type":"object","properties":{"symbol":{"type":"string","description":"Canonical company symbol or catalog alias, e.g. tsla, meta, goog."},"topic":{"type":"string","enum":["overview","moat","fair-value","revenue","valuation","cash-flow","margins","returns","capital","deliveries","optimus"],"default":"overview"},"frequency":{"type":"string","enum":["quarterly","yearly","daily"],"description":"Daily is valuation-only. Defaults to daily for valuation and the available reported frequency otherwise."},"range":{"type":"string","enum":["1Y","3Y","5Y","10Y","ALL"],"default":"5Y","description":"Valuation date range, ending at the latest available point."},"from":{"type":"string","format":"date","description":"Inclusive end/close-date lower bound."},"to":{"type":"string","format":"date","description":"Inclusive end/close-date upper bound."},"deductSbc":{"type":"boolean","default":false},"wacc":{"type":"number","minimum":0,"maximum":100,"description":"WACC percentage scenario. Defaults to the company industry proxy."},"metric":{"type":"string","description":"Optional single metric ID from the page definitions."},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":200},"offset":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"required":["symbol"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_metric_definitions","title":"Read metric definitions","description":"Inspect the financial metric catalog and calculation conventions before comparing companies. Units money/shares denote reporting-currency millions/million shares.","inputSchema":{"type":"object","properties":{"topic":{"type":"string","enum":["valuation","cash-flow","margins","returns","capital"]}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}]}