Oxford Ledge
REMOTE · WWW.OXFORDLEDGE.COM · 2 COMPONENTS
Ask your assistant; it reads the public record: SEC filings, 13F, insider trades, BDC loans.
Available components
Last scanned (22 hours ago)
Scores higher than 52% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security63
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 2 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability64
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 16690 tokens (~256/item across 65 items; 65 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
- Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 65 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 66 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
Checks we ran (12)
- TLS certificate
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Authorization in Endpoint SecurityAuthorisation not fully verified: no authorisation is required to call this server, and 2 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.
- 19 Nov 26 0
- Tool “search_company” rewrote its description, which is the text the model reads security
- 18 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Nov 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- Tool “get_corporate_events” rewrote its description, which is the text the model reads security
- Tool “search_bdc_borrower” rewrote its description, which is the text the model reads security
- Tool “ol_ownership_changes” rewrote its description, which is the text the model reads security
- Tool “ol_institutional_confluence” rewrote its description, which is the text the model reads security
- Tool “ol_insider_recent_buys” rewrote its description, which is the text the model reads security
- Tool “ol_insider_cluster_scan” rewrote its description, which is the text the model reads security
- Tool “ol_borrower_profile” rewrote its description, which is the text the model reads security
- Tool “ol_bdc_borrower_dispersion” rewrote its description, which is the text the model reads security
- Tool “get_institutional_holders” rewrote its description, which is the text the model reads security
- Tool “get_institutional_consensus” rewrote its description, which is the text the model reads security
- Tool “get_insider_activity” rewrote its description, which is the text the model reads security
- “get_fundamentals” added an optional parameter “years” cosmetic
- “get_corporate_events” added an optional parameter “limit” cosmetic
- “ol_ownership_changes” reworded the description of “limit” cosmetic
- 14 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “get_13f_holdings” rewrote its description, which is the text the model reads security
- Tool “get_institutional_consensus” rewrote its description, which is the text the model reads security
- Tool “ol_ownership_changes” rewrote its description, which is the text the model reads security
- Tool “ol_bdc_top_borrowers” rewrote its description, which is the text the model reads security
- New tool “get_bdc_holdings” functional
- New tool “get_access_status” functional
- “ol_ownership_changes” added an optional parameter “sort_by” cosmetic
- “get_institutional_consensus” added an optional parameter “funds_per_ticker” cosmetic
- “ol_bdc_top_borrowers” reworded the description of “limit” cosmetic
- “get_institutional_consensus” reworded the description of “top_n” cosmetic
- 13 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Nov 26 +1
- Stability: unverified → 0.03 ▲ functional
- 10 Nov 26 +28
- Injection markers: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Authorization: Authorisation not fully verified: no authorisation is required to call this server, and 2 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. security
- MCP protocol: unverified → fail ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: fail functional
- First check of Destructive annotations: pass functional
- First check of Schema quality: excellent functional
- First check of Schema quality: fail functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://www.oxfordledge.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=www.oxfordledge.com | CN=WE1,O=Google Trust Services,C=US | 24 Sept 2026 | 23 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | be32319f758cae34131df86c4d5372bb |
| SANs: www.oxfordledge.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of www.oxfordledge.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| oxfordledge.com. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
| referrer-policy | strict-origin-when-cross-origin |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://www.oxfordledge.com/mcp | Verified | 200 | |
| http (plaintext) | http://www.oxfordledge.com/mcp | HTTPS enforced | 301 | https://www.oxfordledge.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
get_13f_holdings 13F Holdings of a Fund ~380
What one institutional filer owns: the largest positions in its latest SEC 13F-HR, plus QoQ changes (keyless: from stored quarters). Accepts a numeric CIK (preferred), a ticker (BRK-B or BRK.B for Berkshire), or a filer NAME (3-80 characters): ONE name-prefix match in the curated 13F filer universe resolves to its CIK (`resolved_from` says so); an ambiguous name is refused with candidates, never guessed. Returns {cik, fundName, filingDate, periodOfReport, totalHoldings, totalValue, holdings}; rows carry name, title_of_class, value (whole USD), shares, type, position_type, lots. There is NO ticker field and `cusip` is stripped on every channel (no plan carries a CUSIP Global Services licence today); `title_of_class` is the share-class discriminator. `position_type` is COM|PRN|PUT|CALL: do NOT sum across types. Source: SEC EDGAR 13F-HR, ~45-day quarterly delay. Heavy operation, max 2 concurrent.
| Name | Type | Req | Description |
|---|---|---|---|
| fund | string | yes | Fund CIK number (e.g. 1067983 for Berkshire Hathaway) -- preferred. A ticker is resolved via SEC's company map: letters with at most one class suffix (e.g. BLK, or BRK-B / BRK.B -- SEC lists Berkshir… |
| max_holdings | integer | – | Maximum number of holdings to return (default 50) |
No output schema declared.
No examples provided.
get_access_status Access Status ~105
Who this server resolved the caller as (caller.kind api_key / bearer / cookie / anonymous, key_presented, key_accepted), the plan, the hourly data-tool budget left (anonymous calls share one budget per network address), and data_through for the 13F and BDC stores. Asking does not spend that budget. A rejected key is refused 401 invalid_api_key before any tool runs. No personal data. Source: Oxford Ledge account and store metadata.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_activist_stakes Activist Stakes (13D/13G) ~228
Schedule 13D/13G >5% beneficial-owner filings for a ticker -- event-driven stake-building, unlike quarterly 13F. Returns {ticker, count, filings}, newest first, limit default 50 (hard cap 200); rows carry filer_name, filing_date, form_type, shares, percent_of_class, accession_number and is_activist (a FORM-TYPE label: true iff the form is a 13D, not a judgement). `reports_zero` is the filer's own statement that it no longer owns more than 5% -- an exit OR a reporting realignment, so cross-check get_institutional_holders before reading it as a sale. FRESHNESS: keyless callers are served STORED rows and never trigger the EDGAR refresh -- read `stale` and `stale_basis`. Complements get_institutional_consensus. Source: SEC EDGAR.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max filings to return (default 50) |
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_anomaly_flags Red-Flag Screens ~220
Run 15 red-flag screens on a ticker (short interest >12%, Altman Z distress, net leverage >4x, negative FCF, P/E >50, dividend yield >6%, insider net selling, revenue decline, payout >90%, goodwill >50% of assets, SBC >10% of revenue, declining ROIC and others). Returns {ticker, available, flags, count}; each flag is {severity, label, detail, scrollTo}: SEVERITY IS ONLY 'red' OR 'amber', red first. A flag is a question to investigate, NOT a sell signal. available: false (+ reason, no flags) = not checked. Empty flags is no all-clear either: a screen missing its input is skipped. Pair with get_fundamentals and ol_intrinsic_value. Source: vendor quote/fundamentals snapshot plus computed heuristics. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_bdc_holdings BDC Holdings ~222
One BDC's portfolio holdings at its latest SERVED SEC filing, paged: `limit` (default 40, max 100) and `offset` window the `holdings` rows (borrower, industry, security type, lien, rate, maturity, par/cost/fair value, mark); `page` and `completeness` say what is left, and every total is the whole filing's. A withheld filing is never served as the book (`withheldFilings` names it). Money is whole USD; marks are percent of par. get_bdc_list lists the tickers. Source: SEC EDGAR schedule-of-investments, Oxford Ledge parse.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Holding rows per page (default 40, max 100). |
| offset | integer | – | Rows to skip before the page (default 0). Past the end returns an empty page with page.total intact. |
| ticker | string | yes | BDC ticker, e.g. ARCC (get_bdc_list lists them). |
No output schema declared.
No examples provided.
get_bdc_list BDC List ~223
Roster of the ACTIVE BDCs tracked by Oxford Ledge, sorted by portfolio size -- our coverage, not the whole BDC universe; wound-down issuers are excluded by design. No arguments. Returns {bdcs, count}; per BDC: ticker, name, listed (false for a non-traded BDC carried under a pseudo-ticker such as AGTC), holdingCount, totalFairValue (whole USD, latest filing), filingDate, lastParsed and a reconciliation block (reportedTotalFairValue, fairValueBasis, parsedRowSumFairValue, fairValueRefused, fairValueGap, fairValueGapNote). READ fairValueBasis BEFORE using totalFairValue, and fairValueGap with it: an under-counting parse keeps the parsed-row sum, which UNDERSTATES the book. holdingCount, totalFairValue and the arbitration are Oxford Ledge's parse, not filer-published figures. Borrower-keyed counterpart: search_bdc_borrower. Source: SEC EDGAR BDC filings (Oxford Ledge parse).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_business_summary Business Summary ~216
First-party business summary for a ticker from its SEC annual report (10-K Item 1; 20-F Item 4 for a foreign private issuer): a curated, verifier-gated overview of what the company does. Returns `summary` (a one-line status line, NOT the content), `available`, `business_summary` (prose truncated at ~2400 chars), `short_summary`, and provenance (source_form, source_period, source_url, generated_at). available=false means the store answered with no verified row and the provenance keys are ABSENT; an unreachable store is REFUSED (DATA_UNAVAILABLE). Rows generated before 2026-09-13 carry '10-K' and an empty `source_period` regardless of filer until Oxford Ledge re-stamps their provenance. For semantic passage retrieval over the full filing corpus use ol_filing_search. Source: SEC EDGAR annual report (Oxford Ledge first-party summary); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_capital_allocation Capital Allocation ~206
Where a company sent its cash, up to 30 annual labels. Returns {ticker, capitalAllocation:{years, periods, dividends, netBuybacks, grossRepurchases, netDebtChange, acquisitions, sharesOut, isDilutive, basis, summary}} as PARALLEL ARRAYS aligned to `years` (newest first, fiscal labels). netBuybacks is a NET, DERIVED DILUTION PROXY, not a buyback figure (repurchases minus issuance, IPO proceeds and SBC); grossRepurchases is the filed line. Share-count cells on a pre-split basis are withheld, never shown as a phantom buyback. An IFRS reporter is REFUSED, never served zeros. Complements get_fundamentals and get_debt_maturities. Source: SEC EDGAR XBRL cash-flow tags, 24h cache. Requires Researcher tier.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_corporate_events Corporate Events ~394
The most recent 8-K item events for a ticker from Oxford Ledge's 8-K index of SEC EDGAR, NEWEST FIRST: `limit` 1-20 (default and hard cap 20), so a recent-events feed, not a history. Returns {ticker, events, count, coverage, summary}; each event is {ticker, eventDate, eventType, headline, description, counterparty, counterpartyTicker, sourceUrl, source}. `eventType` is Oxford Ledge's 8-K item-to-category map. The event_type filter matches STORED CATEGORIES ONLY; for M&A use acquisition_disposition. Dual-class siblings (GOOG/GOOGL) are unioned. An unreachable store REFUSES (DATA_UNAVAILABLE) rather than serving events=[]. For Form 4 insider transactions use get_insider_activity. Source: SEC EDGAR 8-K index (Oxford Ledge parse), re-indexed about every 7 days.
| Name | Type | Req | Description |
|---|---|---|---|
| event_type | string | – | Optional filter, case-insensitive; one category, a comma-separated list, or ALL (the default). The STORED vocabulary is the 17 8-K item categories: material_agreement, material_agreement_termination,… |
| limit | integer | – | Maximum events to return, newest first (default 20, hard cap 20). |
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_debt_maturities Debt Maturities ~177
Forward debt maturity ladder parsed from the latest 10-K/20-F footnote. Returns {ticker, maturities:[{year, amount}], thereafter, confidence, confidence_score, source, validation}. AMOUNTS ARE IN MILLIONS OF USD, not raw dollars -- 400 means $400M. THE LADDER IS AS OF the filing date, not today: the current-year bucket may already be repaid or refinanced. Check `validation` (the balance-sheet cross-check) before quoting a total. Every empty answer carries `refusal_reason` and a readable `refusal_note`. For historical issuance/repayment use get_capital_allocation. Source: SEC EDGAR 10-K note extraction. Requires Researcher tier.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_economic_calendar Economic Calendar ~193
Upcoming US macro DATA-RELEASE DATES (a schedule, not estimates) for the 8 tracked releases (CPI, Employment Situation, GDP, Jobless Claims, PCE, PPI, Industrial Production, Retail Sales). Returns {days, events, count, withheld, source_status, error}; each event is {date, event, release_id, release_name, label_source}: release_name is FRED's OWN name; event is our label only when label_source is 'ol'. No values; no FOMC dates. `days` default 90; above 180 is REFUSED. ALWAYS CHECK source_status: every failure returns events=[], like a quiet calendar. Cached 6h. Source: FRED releases/dates. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days to look ahead (default 90) |
No output schema declared.
No examples provided.
get_fails_to_deliver Fails to Deliver ~275
SEC fails-to-deliver history for one ticker -- the settlement-failure side of short pressure. Returns {ticker, days, history, count, window, coverage, as_of, summary}; each row is {date (settlement date), fails (SHARES, not dollars), price (USD), description}, OLDEST-FIRST. `days` (default 180, hard cap 730) is anchored to the latest LOADED settlement date, not to today; `end_date` ends it elsewhere. An empty or thin history describes the loaded SEC files, not an absence of fails: read `coverage` and `summary` before reading a gap. Prices are NOT split-adjusted. An unreachable store REFUSES (DATA_UNAVAILABLE). Pair with ol_short_interest_trend for the other half. Source: SEC Fails-to-Deliver dataset (published twice monthly, ~3-week lag).
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Trailing window in days (default 180, max 730), ending at `as_of` unless end_date is given |
| end_date | string | – | ISO date (YYYY-MM-DD) the window ends on; default = the latest loaded settlement date. Pass today's date to measure against the calendar. |
| ticker | string | yes | Stock ticker symbol (e.g. GME) |
No output schema declared.
No examples provided.
get_fred_data FRED Series ~288
One series from Oxford Ledge's macro SNAPSHOT (about 41 FRED / Treasury series, newest observation each) by FRED id. Returns {series, data: {series, name, value, date, ytdChange, _source}, observation: 'latest_only', note} -- ONE observation, never a history. A series outside the snapshot returns {series, error, available}. THIRD-PARTY LICENSED SERIES ARE REFUSED WITH THE REASON (2026-09-13): the ICE BofA OAS credit spreads (BAMLH0A0HYM2, BAMLC0A0CM, BAMLC0A1CAAA, BAMLH0A1HYBB, BAMLH0A2HYB, BAMLH0A3HYC), VIXCLS and UMCSENT are licensed content FRED redistributes under its own terms and Oxford Ledge does not; the answer is {series, data: null, refusal_reason: 'third_party_licence', licensor, error, note, directional, directional_unavailable_reason}. RESTRICTED posture: a keyed tool on the hosted channel. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| series | string | yes | FRED series ID (e.g. GDP, UNRATE, CPIAUCSL, DFF) |
No output schema declared.
No examples provided.
get_fundamentals Company Fundamentals ~305
Full XBRL financial history for one ticker. Returns {ticker, fundamentals:{years, periods, metrics, balanceSheet, quarterly, basis, as_of}, source_period, as_of}: `years` is newest-first, UP TO 30 annual labels, and every entry under `metrics` / `balanceSheet` is a PARALLEL ARRAY aligned to it by index (revenue, netIncome, opCF, capex, epsDiluted, totalDebt, cash, derived fcf and margins ...). Dollar figures are whole USD; *Pct values are percentage numbers. A year the filer did not tag is null, never 0. Per-share cells on a pre-split basis are WITHHELD (null) rather than rescaled -- read `basis`. An IFRS reporter or a filer with no annual us-gaap fact returns {error, taxonomy, formsSeen, unitsSeen}. For cash deployment use get_capital_allocation; for per-share fair value ol_intrinsic_value; for industry operating metrics ol_operating_kpis. Source: SEC EDGAR company-facts XBRL (~45-day post-quarter lag), 24h cache.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
| years | integer | – | Keep only the newest N fiscal years of the annual arrays (optional; omitted returns every stored year, up to 30). `quarterly` and `basis` are not cut. |
No output schema declared.
No examples provided.
get_insider_activity Insider Activity ~275
Use for one ticker's own Form 4 insider transaction rows. Returns {ticker, transactions}: THE 20 MOST RECENT TRANSACTION ROWS ONLY, newest by filing date; `days` filters within those 20 (it never reaches past the 20). Rows carry insiderName, position (the role, the load-bearing signal), transType (the raw SEC code: 'P' open-market buy, 'S' sale, 'A' grant, 'M' option exercise; filter on it yourself), shares, pricePerShare, totalValue (USD, computed by Oxford Ledge at ingest), isDerivative (read it before treating `shares` as common stock) and url. A 4/A that repeats its original line is served once. Leave issuerSelfFiled rows out of any total. No tier needed: ol_insider_recent_buys (market-wide), ol_insider_cluster_scan (clusters); >5% stakes: get_activist_stakes. Source: SEC EDGAR Form 4 (~2-day filing deadline). Requires Researcher tier.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Optional. Keeps only rows filed within this many days, applied to the 20 newest rows. Omitted: no date filter. |
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_institutional_consensus Most Widely Held (13F) ~271
Use for 'what do the tracked 13F filers hold most widely?' (takes no ticker). Returns {as_of_quarter, tickers_found, min_funds, consensus}; each row is {ticker, issuer_name, fund_count, total_value_usd, total_shares, funds}, ranked by fund_count then value. `consensus` is truncated to top_n (default 10, cap 200) and each row's `funds` to funds_per_ticker (default 5, cap 25); `tickers_found` is the FULL count meeting min_funds (default 2, cap 20). COMMON STOCK ONLY: an ownership tally, not exposure. Each fund contributes its own latest quarter. For one ticker's buyers: ol_ownership_changes. Source: SEC EDGAR 13F-HR, ~45-day quarterly delay.
| Name | Type | Req | Description |
|---|---|---|---|
| funds_per_ticker | integer | – | Fund rows listed under each ticker, by value (default 5, max 25). |
| min_funds | integer | – | Minimum number of notable funds that must hold a ticker for it to appear (default 2, max 20). |
| top_n | integer | – | Maximum number of consensus tickers to return (default 10, max 200). |
No output schema declared.
No examples provided.
get_institutional_holders Institutional Holders ~258
Use for 'who holds X?': which institutions hold one ticker, and which way each moved. Returns {ticker, holders, total_holders, as_of_quarter, coverage}. `holders`: the first `limit` (default 25, max 100) of the top 100 by value; `total_holders` is the TRUE filer count. Each holder carries fund_name, fund_cik, shares, value_usd (whole USD), quarter, change_type and pct_change vs that fund's prior quarter. Check `coverage.basis` ('universe' vs 'top_display') before quoting an aggregate. Common stock only; quarters can differ per row. Rows are CUSIP-resolved: a resolution failure drops or mis-attributes a row. For 'are they buying X?' use ol_ownership_changes; by fund: get_13f_holdings. Source: SEC EDGAR 13F-HR, ~45-day quarterly delay.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Holders to return from the top-100-by-value page (default 25, max 100); total_holders and coverage are unchanged. |
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
get_news Company News ~197
Read the Oxford Ledge news archive by ticker and/or keyword, newest first. Default limit 25, hard cap 100; no pagination offset. THE RESPONSE SHAPE DEPENDS ON THE ARGUMENTS: ticker only returns {articles, total}; any free-text query returns {articles, count} with richer rows (publisher, snippet, sentimentScore, tickers, tags). Handle both. `sentiment` is a LABEL string, NOT a number. Query matching is prefix-word, not semantic. Source: Oxford Ledge news archive (multi-provider, cron-populated). Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results to return (default 25, max 100) |
| query | string | – | Search query (e.g. 'tariff', 'earnings beat') |
| ticker | string | – | Filter to a specific ticker (e.g. AAPL) |
No output schema declared.
No examples provided.
get_portfolio_positions Portfolio Positions ~166
Stored positions of one saved portfolio. Returns {portfolio_id, positions, error} on EVERY path (error is null on success, a string on failure, and positions is [] either way). Each position is ONLY {ticker, shares, costBasis (whole USD, may be null)}, ticker-sorted. THERE IS NO PRICE LEG: no price, market value, gain/loss or weight -- value the positions yourself. An unknown portfolio_id yields positions=[] with error=null, so an empty list does not prove the portfolio exists. For the catalog-wide sector mix use get_sector_breakdown. Source: the portfolio's stored positions. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolio_id | string | – | Portfolio identifier (default: 'default') |
No output schema declared.
No examples provided.
get_sector_breakdown Sector Breakdown ~147
How Oxford Ledge's covered universe splits across sectors and industries (the whole catalog, NOT a portfolio). No arguments. Returns a BARE LIST of {sector, industry, tickerCount, totalMarketCap}, one row per sector+industry PAIR -- aggregate rows to get a sector total. totalMarketCap IS ALWAYS NULL: a count-only breakdown. Rows with a blank sector are excluded; a blank industry is null. Each industry sits under the ONE sector holding most of its tickers. Returns {error} (a dict) when the read fails. For a named portfolio use get_portfolio_positions. Source: Oxford Ledge company profiles, ~5,200 tickers.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_value_investing_fact Value Investing Facts ~231
Curated value-investing principle, historical fact or attributed paraphrase from Oxford Ledge's corpus (~2,000 entries about Buffett, Graham, Munger, Klarman and others). THE WORDING IS NOT VERIFIED against the primary source: none is a verbatim quotation unless `verbatim` is true -- so never present the text as the author's exact words, and credit it with the `attribution` line. THE SHAPE DEPENDS ON THE ARGUMENTS: a `query` returns {facts, count, total_facts} (facts capped at 10); a bare `category` or no arguments returns {fact, total_facts} (one random pick). Pedagogical content only -- never a market signal. Cached 24h per argument set.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Optional category filter, one of the listed values (case-insensitive); omit for a random pick. Any other value is refused (INVALID_PARAMS) naming the values. |
| query | string | – | Optional search query to find facts by keyword (e.g. 'moat', 'fear') |
No output schema declared.
No examples provided.
get_yield_curve Treasury Yield Curve ~206
US Treasury yield curve, plus (by default) the wider macro dashboard. TWO DIFFERENT SHAPES. include_history=true returns PARALLEL ARRAYS over 11 tenors (1M..30Y) -- today, ~91 days ago and ~1 year ago -- for steepening/inversion work. include_history false (the DEFAULT) returns {data: [...]}, a flat LIST of latest-value rows that mixes the Treasury tenors WITH CPI, unemployment, GDP, mortgage-rate and national-debt series. UNITS: yields are PERCENT numbers (4.25 means 4.25%). The credit-spread OAS series and UMCSENT were removed 2026-07-21 (licensed data) and are NOT in the list. Source: Treasury.gov daily par yields (FRED fallback) plus FRED series; cached 4h.
| Name | Type | Req | Description |
|---|---|---|---|
| include_history | boolean | – | Include yield curve from 1 year ago for comparison (default false) |
No output schema declared.
No examples provided.
ol_13f_filer_analytics 13F Filer Analytics ~192
Institutional-filer behavior derived purely from 13F holdings: concentration (top-N %, normalized HHI), turnover, and persistence (long-term holder vs fast money) for one filer. Pass a NUMERIC CIK (a ticker will not resolve here; ol_13f_filer_search finds it). Returns {summary, fund, quarter, n_positions, reported_long_equity_value, analytics}. The denominator is the filer's REPORTED 13F long-equity value, explicitly NOT AUM. NO position list -- use get_13f_holdings. A filer with one stored quarter gets no fabricated turnover rate; an unreachable store is REFUSED (DATA_UNAVAILABLE). Source: SEC EDGAR 13F-HR (public domain; Oxford Ledge derived); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| fund | string | yes | 13F filer CIK (e.g. 1067983). |
No output schema declared.
No examples provided.
ol_13f_filer_search 13F Filer Search ~251
Resolve a 13F FILER name to its CIK -- the front door to get_13f_holdings and ol_13f_filer_analytics when you know the manager ('Berkshire Hathaway', 'Baupost') and not its CIK (search_company resolves ISSUERS). Returns {summary, query, filers: [{cik, name, last_filing, page_url}], count}; name-PREFIX matches rank first. THE UNIVERSE IS CURATED -- the filers Oxford Ledge ingests plus featured filers, never a live EDGAR full-text search. filers=[] means the store answered and nothing matched; an unreachable store is REFUSED (DATA_UNAVAILABLE). `query` 3-80 characters; `limit` default 5, hard cap 10. Source: SEC EDGAR 13F-HR (public domain; Oxford Ledge derived); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max filers to return (default 5, hard cap 10). |
| query | string | yes | Filer name or fragment, 3-80 characters (e.g. 'Berkshire', 'Baupost'). |
No output schema declared.
No examples provided.
ol_bank_structure_events Bank Structure Events ~199
FDIC STRUCTURAL EVENTS for one bank -- failures, assisted resolutions, mergers, acquisitions, charter changes -- newest first, with is_failure flagged from the FDIC CHANGECODE taxonomy. Pass `cert` (FDIC certificate) or `name`; a name resolves against active institutions AND closed charters, so a FAILED or merged-away bank (Signature Bank, First Republic) IS found, and `resolved_from` says which charter matched. Ambiguous names return an `ambiguous` candidate list instead of guessing -- call again with the `cert`. An unreachable FDIC store is DATA_UNAVAILABLE, never an empty list. Complements ol_fdic_bank (active institutions only). Source: FDIC public data; FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| cert | integer | – | FDIC certificate number. |
| limit | integer | – | Max events (default 25, cap 100). |
| name | string | – | Bank name to resolve when cert is unknown. |
No output schema declared.
No examples provided.
ol_bdc_borrower_dispersion BDC Loan Mark Dispersion ~332
Use for 'do the lenders agree on this loan?': cross-lender loan-pricing DISPERSION for one private-credit borrower -- how N different BDCs each price the SAME loan (spread / mark / fair value). Pass `borrower_norm` (a key from ol_bdc_top_borrowers or search_bdc_borrower, or a name). Returns {summary, borrower_norm, count, lender_count, tranche_count, lenders, ...}: ONE row per BDC lender, widest spread first, tranches nested. UNITS TRAP: `spread` is the raw as-filed number and mixes percent and bps across filers -- compare lenders on `spread_bps` only. Exited/inactive lenders are excluded by default (include_stale shows them). Default 25 lenders, cap 100. Source: SEC EDGAR BDC schedules of investments (Oxford Ledge parse; ol-derived).
| Name | Type | Req | Description |
|---|---|---|---|
| borrower_norm | string | yes | Borrower key (from ol_bdc_top_borrowers or search_bdc_borrower) or a borrower name such as 'Coupa Holdings, LLC'; resolved to the stored key (see match_type). |
| include_stale | boolean | – | Include NON-CURRENT lenders: those whose newest filing no longer names this borrower (stale marks) and inactive (wound-down) filers' frozen final filings, listed after the current lenders. Default fa… |
| limit | integer | – | Max LENDERS to return (default 25, hard cap 100); each lender's tranches ride nested. |
No output schema declared.
No examples provided.
ol_bdc_borrower_news_today BDC Borrower News ~258
MOAT / daily pulse: recent VERIFIED news for the private-credit borrowers held across MULTIPLE BDCs -- 'what broke recently for the cross-BDC borrowers I should watch?'. Returns {summary, count, items}; each item is {borrower, headline, source, url, date}. Matcher-VERIFIED only (>=0.9 confidence) and headline + link only, NO provider summary, so a false attribution cannot surface. Caps: limit default 25 / hard 100; since_days default 7 / hard 90; min_holders default 2 (max 50). No recent headlines returns items=[] -- absence is not a signal; an unreachable store is REFUSED (DATA_UNAVAILABLE). Source: Google News, matched to SEC EDGAR BDC borrowers; FREE. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max news items to return (default 25, hard cap 100). |
| min_holders | integer | – | Minimum number of BDC lenders a borrower must appear in (default 2). |
| since_days | integer | – | How many days back to look (default 7, hard cap 90). |
No output schema declared.
No examples provided.
ol_bdc_common_borrowers BDC Common Borrowers ~297
Borrowers common to a GIVEN SET of BDCs -- the cross-portfolio set question ('what do ARCC, OBDC and AGTC all lend to?') in ONE call. Returns per borrower: borrower, borrower_norm, holder_count, holder_tickers, holders ([{ticker, name}]), total_fair_value and total_par_amount in USD, and as_of_oldest/as_of_newest. Each BDC is read at ITS most recent filing, so rows MIX filing dates -- read as_of_range before treating the marks as contemporaneous. Debt positions only. Caps: bdc_tickers truncated at 25, limit 50/200, min_holders max 50. Feed a borrower_norm to ol_bdc_borrower_dispersion for cross-lender pricing. Source: SEC EDGAR BDC schedules of investments (Oxford Ledge parse -- ol-derived); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| bdc_tickers | array | yes | BDC symbols to intersect, e.g. ["ARCC","OBDC","AGTC"] (max 25) |
| limit | integer | – | Max borrowers to return (default 50, max 200) |
| min_holders | integer | – | Minimum number of the supplied BDCs that must hold the borrower (default 2, min 2 -- this answers what is SHARED; for one BDC's book use ol_bdc_top_borrowers) |
No output schema declared.
No examples provided.
ol_bdc_credit_quality BDC Credit Quality ~238
BDC non-accrual credit-deterioration signal: the share of debt fair value on non-accrual (loans that stopped paying) in the latest filing, plus the trailing-quarter trend. Returns {summary, ticker, latest, trend}; `trend` is OLDEST-FIRST. flagged_pct is a percentage over the DETERMINATE-flag denominator, never total_debt_fv, and it is deliberately NULL (withheld, never zero) when determinate coverage is under 90% of debt fair value or the flag rate looks like a parse misread -- read `coverage_state` before reading flagged_pct. `quarters` default 12, hard cap 24. Pairs with ol_bdc_borrower_dispersion and ol_bdc_top_borrowers. Source: SEC EDGAR BDC schedule-of-investments non-accrual flags (Oxford Ledge parse); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| quarters | integer | – | Trailing quarters of trend (default 12, hard cap 24). |
| ticker | string | yes | BDC ticker (e.g. ARCC, ORCC, FSK). |
No output schema declared.
No examples provided.
ol_bdc_fee_load BDC Fee Load ~199
BDC fee load + NII-based dividend coverage for ONE fiscal year (not a series). Returns {summary, ticker, fiscal_year, fees, dividend_coverage}; `fees` holds base and incentive fees and net investment income in whole USD; `dividend_coverage` is NII divided by dividends paid, a ratio (0.92 means 0.92x) -- under 1.0 means the dividend is funded partly from capital. Fee RATE percentages and the dividend amount are not returned. A missing input is served as null and named, never as zero; an unreachable store is REFUSED (DATA_UNAVAILABLE). An internally-managed BDC carries no fee lines by construction. Source: SEC EDGAR 10-K/10-Q Statement-of-Operations XBRL, NOT a vendor fundamentals feed; FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | BDC ticker (e.g. ARCC, MAIN, HTGC). |
No output schema declared.
No examples provided.
ol_bdc_loan_pricing_trend BDC Loan Pricing Trend ~219
Per-quarter loan-pricing trend for ONE BDC, from the parsed schedule of investments: fair-value-weighted average credit spread, average mark and position counts, OLDEST-FIRST. Returns {summary, ticker, count, spread_unit, trend}. `weighted_avg_spread` is in BASIS POINTS, normalized at the store (the as-filed column mixes percent and bps, so never average a raw spread yourself). Prefer `priced_borrowers` over `debt_positions` across quarters: position counts are parser-grain-dependent. `quarters` default 16, max 24. Honest-empty (trend=[]) for an unparsed BDC. Pairs with ol_bdc_borrower_dispersion. Source: SEC EDGAR BDC 10-Q/10-K schedules of investments (Oxford Ledge parse); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| quarters | integer | – | Quarters to return (default 16, max 24). |
| ticker | string | yes | BDC ticker (e.g. ARCC). |
No output schema declared.
No examples provided.
ol_bdc_mark_changes BDC Mark Changes ~292
MOAT / private credit: the largest quarter-over-quarter MARK moves across a SET of BDC portfolios -- 'which borrowers got marked up or down the most last quarter, and by whom' in ONE deterministic call. Returns {increases, decreases}, each a global ranking; each row is {borrower, portfolio, prior_mark, latest_mark, mark_delta, prior_filing, latest_filing}. Marks are percent of par, fair-value-weighted across the BDC's tranches; mark_delta is in points. A borrower enters only when |mark_delta| >= 1.0 point and its fair value is >= $500k. Implausible moves are held in `suspect_moves` rather than ranked. `coverage` names every BDC that was NOT read and why. bdc_tickers capped at 25; limit default 10 / hard 50 per direction. Source: SEC 10-K/10-Q schedules of investments (Oxford Ledge parse); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| bdc_tickers | array | yes | BDC symbols to compare, e.g. ["ARCC","FSK","OBDC"] (max 25; the excess is reported in `coverage.not_covered_detail` rather than dropped) |
| limit | integer | – | Rows per direction (default 10, hard cap 50). Ranking is GLOBAL across the supplied portfolios, not per BDC. |
No output schema declared.
No examples provided.
ol_bdc_top_borrowers BDC Top Borrowers ~229
MOAT / BDC discovery: the private-credit borrowers syndicated across the MOST BDCs, ranked by ACTIVE lender count (holder_count_active), then holder_count, then exposure -- the entrypoint for the BDC/private-credit category. Returns {summary, count, borrowers}; each row is {borrower, borrower_norm (the key other ol_bdc_* tools take), holder_count, total_fair_value (whole USD, latest filings), industry}. Feed a borrower_norm into ol_bdc_borrower_dispersion for cross-lender pricing. Caps: limit default 10 / hard 100; min_holders default 2 (max 50). Parser mis-ingests are filtered out when the filter is available (`borrower_filters` says whether it ran). Source: SEC EDGAR BDC schedules of investments (Oxford Ledge parse); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max borrowers to return (default 10, hard cap 100). |
| min_holders | integer | – | Minimum number of BDC lenders a borrower must appear in (default 2). |
No output schema declared.
No examples provided.
ol_bond_directory_screen Bond Directory Screen ~421
Screen the corporate-bond browse directory by issuer name, grade (IG or HY), and optional coupon and maturity bands. Returns {summary, count, total_matching, bonds}; each bond is {key, issuer_name, coupon (percent number), coupon_type, maturity_date, grade, source_etf}. REFERENCE DATA ONLY -- no price, yield, spread or trade activity, and no security identifier. `grade` is the coarse SOURCE BUCKET (IG=LQD, HY=HYG), NOT a credit rating. limit default 25, hard cap 100. NOTE ON PROVENANCE: the directory is sourced from the LQD (investment-grade) and HYG (high-yield) ETF holdings. Its ingest-source redistribution posture is unresolved (Oxford Ledge legal review, 2026-07-07), so this is a FIRST-PARTY-only tool and is off the third-party redistribution surface until cleared. FREE. Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| coupon_max | number | – | Maximum coupon percent, applied in-tool over the fetched page (optional). |
| coupon_min | number | – | Minimum coupon percent, applied in-tool over the fetched page (optional). |
| grade | string | – | Source bucket: 'IG' (LQD universe) or 'HY' (HYG universe), case-insensitive. Not a rating. |
| issuer | string | – | Issuer-name substring to match (optional). Identifier lookups are not supported. |
| limit | integer | – | Max bonds to return (default 25, hard cap 100). |
| maturity_after | string | – | Only bonds maturing on/after this ISO date (YYYY-MM-DD), optional. |
| maturity_before | string | – | Only bonds maturing on/before this ISO date (YYYY-MM-DD), optional. |
| offset | integer | – | Pagination offset. Not accepted with a coupon/maturity band (a band reads the first 200 issuer/grade matches; there is no banded page to offset into). |
No output schema declared.
No examples provided.
ol_borrower_profile Private Borrower Profile ~277
Use for 'who is this borrower?': profile + verified M&A/ownership history for one private-credit borrower (pricing: ol_bdc_borrower_dispersion). Pass `borrower_norm` (a key from ol_bdc_top_borrowers, or a name). Returns {summary, borrower_norm, borrower, profile, acquisitions, count, public_footprint}: the `profile` (description, industry, known_lenders, lien_position, estimated_size, notes, source), VERIFIED-only `acquisitions` (unaudited or refuted events never surface), and `public_footprint` (patents, federal contracts, corporate events) matched by exact normalized name, with `matched_entities` provenance -- a same-name match is never a guaranteed identity, and an empty footprint is normal for a private borrower. An unknown key returns empty. Source: SEC EDGAR BDC Schedule-of-Investments + attributed public M&A events (Oxford Ledge proprietary parse).
| Name | Type | Req | Description |
|---|---|---|---|
| borrower_norm | string | yes | Borrower key (from ol_bdc_top_borrowers) or a borrower name such as 'Coupa Holdings, LLC'; resolved to the stored key (see match_type). |
| limit | integer | – | Max M&A/ownership events to return (default 20, hard cap 100). |
No output schema declared.
No examples provided.
ol_cftc_cot CFTC Commitments of Traders ~286
CFTC Commitments-of-Traders positioning for THREE curated markets (keys gold, crude_oil, sp500). Pass `market` for its weekly history, NEWEST FIRST (names are normalised: 'wti', 'GOLD', 'e-mini s&p' resolve), or omit it for the latest report across the three. Returns {summary, market, matched_market, rows}. mm_* and open_interest are CONTRACT counts, not dollars, and mm_* cover ONE speculative category per report family (Managed Money for gold and crude_oil, Leveraged Funds for sp500). `limit` (series only) default 52, hard cap 156. An unreachable store is REFUSED (DATA_UNAVAILABLE). Source: CFTC.gov (public domain); FREE. ATTRIBUTION: every field is CFTC verbatim EXCEPT market_key and market_label (Oxford Ledge's curated market catalog) and mm_net (mm_long minus mm_short, computed by Oxford Ledge).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Weekly reports for a market series (default 52, hard cap 156). |
| market | string | – | Market key, CFTC report name or desk symbol -- gold / GC / XAU, crude_oil / CL / WTI, sp500 / ES / S&P (case-insensitive; omit for the latest all-market snapshot). |
No output schema declared.
No examples provided.
ol_earnings_calendar Earnings Calendar ~161
Upcoming EARNINGS DATES for one issuer, provenance-labelled: published_events are dates the ISSUER posted on its own IR calendar; estimate is an Oxford Ledge projection from the issuer's SEC filing cadence, with its confidence. Returns {ticker, published_events, published_events_degraded, estimate, provenance_rule, note}. The two are NOT merged: prefer a published date yourself, and never present the estimate as a company announcement. SCOPE: US domestic 8-K filers only. Read published_events_degraded before reading the note as an issuer fact. Distinct from get_economic_calendar (macro releases). Source: issuer IR pages + SEC filing cadence (Oxford Ledge); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Issuer symbol. |
No output schema declared.
No examples provided.
ol_etf_lookthrough ETF Look-Through ~251
ETF look-through: expand up to 25 ETF tickers into the underlying holdings the fund ITSELF filed on Form N-PORT. Returns {summary, count, etfs, units}; per ETF {etf, name, category, net_assets, in_catalog, series_id, opaque, reason, period_date, holdings_available, top_holdings}. `top_holdings` is value-ranked (default 10, hard cap 50), each with underlying_ticker, issuer_name, value_usd (whole USD), pct_of_nav (as filed) and weight_pct (Oxford Ledge derived; the shown rows will not sum to 100). HOLDINGS-ONLY: no yield, NAV or premium. An ETF with no filed holdings comes back opaque=true with `reason`; a store outage is DATA_UNAVAILABLE, never opaque. Source: SEC EDGAR N-PORT, latest filed period per series (~60-day lag); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| tickers | array | yes | ETF ticker symbols to expand (e.g. ['VOO','QQQ']). Max 25. |
| top_holdings | integer | – | Max underlying holdings per ETF (default 10, hard cap 50). |
No output schema declared.
No examples provided.
ol_fdic_bank FDIC Bank Lookup ~218
FDIC-insured banks and thrifts. Pass `query` for a name PREFIX search against ACTIVE institutions (largest-asset first), or omit it for the largest active institutions. Returns {summary, query?, found?, institutions}. UNITS: `asset` and `dep` are THOUSANDS of dollars. The store is loaded ACTIVE-ONLY, so a bank that merged away or failed is absent by construction; a name miss says whether a structure event explains it (`structure_event`). An unreachable store is REFUSED (DATA_UNAVAILABLE). `limit` default 25, hard cap 100. Source: FDIC.gov (public domain); FREE. ATTRIBUTION: every field is FDIC BankFind verbatim EXCEPT `ticker`, which is an Oxford Ledge-verified CERT-to-ticker mapping, not an FDIC-published field.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max institutions (default 25, hard cap 100). |
| query | string | – | Institution name prefix (omit for the top-by-assets list). |
No output schema declared.
No examples provided.
ol_federal_contracts Federal Contracts ~273
Federal-contract obligation history for a ticker, OR the fiscal-year leaderboard -- for government-revenue-dependence diligence. TWO SHAPES: exactly one of `ticker` or `fiscal_year` is REQUIRED (both is refused). With `ticker`: per-fiscal-year obligations (USD, the ten largest recipients, dropped_unresolved), NEWEST FY FIRST; with fiscal_year only: a leaderboard of the public companies on Oxford Ledge's USAspending crosswalk, largest first -- not of all federal contractors. A fiscal year still in progress is PARTIAL (period_complete false) and year-to-date -- never compare it to a full year. Obligations are federal awards, not company-reported revenue. `limit` default 20, hard cap 100. An unreachable store is REFUSED (DATA_UNAVAILABLE). Source: USAspending.gov (public domain; OL ticker-crosswalked); FREE. Attributing awards to a ticker is an Oxford Ledge curated crosswalk.
| Name | Type | Req | Description |
|---|---|---|---|
| fiscal_year | integer | – | Fiscal year for the top-contractors leaderboard (not with ticker). |
| limit | integer | – | Max rows (default 20, hard cap 100). |
| ticker | string | – | Stock ticker for its per-year history (omit for the FY leaderboard; not with fiscal_year). |
No output schema declared.
No examples provided.
ol_filing_search SEC Filing Search ~275
MOAT (PAID -- AI): semantic retrieval over EMBEDDED SEC filings for a ticker. Ask a natural-language question ('what did they say about supply-chain risk?') and get the most relevant filing CHUNKS back from an Oxford Ledge hybrid retrieval (lexical BM25 plus a dense pass, fused by reciprocal rank). This is the ONE metered tool: it draws on your daily AI quota (25 searches/day, UTC reset, plus a burst limiter) -- it needs a signed-in account or an API key, and an anonymous call fails AUTH_REQUIRED. Returns {summary, ticker, count, chunks, quota_remaining_today}; each chunk is {section, text (an excerpt), accession, url, score}. `score` is the FUSED RANK score (4dp), NOT a similarity: compare it only within one response. `k` default 5, hard cap 15. Source: SEC EDGAR filings (Oxford Ledge embedded corpus). Needs a free Oxford Ledge API key that the client's operator configures.
| Name | Type | Req | Description |
|---|---|---|---|
| k | integer | – | Number of chunks to return (default 5, hard cap 15). |
| query | string | yes | Natural-language question to retrieve relevant filing passages for. |
| ticker | string | yes | Stock ticker symbol (e.g. AAPL) |
No output schema declared.
No examples provided.
ol_form_d_raises Form D Private Raises ~207
Recent SEC Form D private-placement filings from the SEC's QUARTERLY Form D data set -- newest first, optionally scoped to an industry group and/or a trailing filing-date window. Returns {summary, count, days, industry, offerings}. Amounts are whole USD as disclosed; total_offering_amount is a ceiling, not money raised. The data set lands about one quarter after quarter-end, so a short `days` window is EMPTY BY CONSTRUCTION -- not evidence that nothing was filed. `limit` default 50, hard cap 200. Source: SEC EDGAR Form D data sets (public domain); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Trailing filing-date window in days (optional). The data set is quarterly with ~1 quarter of posting lag: a window shorter than that is empty by construction. |
| industry | string | – | Industry group filter (optional). |
| limit | integer | – | Max offerings (default 50, hard cap 200). |
No output schema declared.
No examples provided.
ol_fundamentals_screen Fundamentals Screen ~301
Threshold screen over up to 10 caller-supplied tickers (extras named in `dropped`) on latest-year SEC EDGAR XBRL fundamentals. Optional criteria: min_revenue, min_free_cash_flow, min_ebit_margin_pct, min_gross_margin_pct, max_debt_to_assets_pct, min_current_ratio, min_net_income (whole USD; *_pct as percentage numbers). Each result carries verdict: pass, fail (a reported value misses a threshold, in failed_criteria) or unknown (a metric not filed for the latest year, in unevaluated_criteria; unknown is not a fail). Not a universe screen; a fundamentals filter, NOT a buy signal. Source: SEC EDGAR company-facts XBRL.
| Name | Type | Req | Description |
|---|---|---|---|
| max_debt_to_assets_pct | number | – | Max debt-to-assets (percent). |
| min_current_ratio | number | – | Min current ratio. |
| min_ebit_margin_pct | number | – | Min EBIT margin (percent). |
| min_free_cash_flow | number | – | Min latest-year free cash flow (USD). |
| min_gross_margin_pct | number | – | Min gross margin (percent). |
| min_net_income | number | – | Min latest-year net income (USD). |
| min_revenue | number | – | Min latest-year revenue (USD). |
| tickers | array | yes | 2-10 candidate ticker symbols to screen (hard-capped at 10). |
No output schema declared.
No examples provided.
ol_glossary_term Glossary Term ~139
Oxford Ledge's editorial GLOSSARY: ~1,500 finance and investing terms written for lifelong students of the market -- definition, worked example, etymology, pronunciation, related terms (see-also), and the learning paths that teach the concept. Look up one term by name (case and punctuation tolerant: 'first lien', 'convexity', 'duration'). Use it to ground explanations in the SAME definitions the platform teaches from, instead of improvising one. Source: Oxford Ledge editorial (reviewed in-house); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| term | string | yes | The term to look up, e.g. 'duration'. |
No output schema declared.
No examples provided.
ol_insider_cluster_scan Insider Cluster Scan ~363
Use for 'are insiders buying or selling together?': ACTIVE multi-insider cluster-buy/sell signals (distinct-actor Form 4 clusters with statistical strength), not single trades (those: ol_insider_recent_buys). THREE GRAINS: pass `tickers` for a watchlist, a single `ticker` for that name's recent fired clusters, or NEITHER for the MARKET-WIDE scan (top fired clusters across every ticker, one row per ticker and direction). Returns {summary, count, events, grain, since_days, limit}; each event is {ticker, direction, insider_count, z_score, sector_z_score, percentile, window_start, window_end}. No fired clusters returns events=[] -- absence is not a signal; an unreachable store is REFUSED. Source: SEC EDGAR Form 4, windowed on FILING date so it is look-ahead-safe.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max events to return (default 25, hard cap 100; market-wide grain: default 10, max 25, more is refused). |
| min_insider_count | integer | – | Minimum distinct insiders for a fired cluster (default 3). |
| since_days | integer | – | Window in days: watchlist default 7 (max 365); market-wide default 30 (max 90; more is refused); not accepted with `ticker` (that grain has no window). |
| ticker | string | – | Single ticker for its recent fired clusters (alternative to `tickers`). Omit BOTH for the market-wide scan. |
| tickers | array | – | Watchlist of ticker symbols (e.g. ['AAPL','MSFT']). Max 100. Use this OR `ticker`, not both. |
No output schema declared.
No examples provided.
ol_insider_recent_buys Recent Insider Buys ~343
Use for 'who is buying lately, market-wide?' (takes NO ticker): recent OPEN-MARKET insider PURCHASES (SEC code 'P') across the Oxford Ledge issuer catalog (~5.3k tickers). Returns {summary, since_days, count, buys}, NEWEST FIRST; each buy carries ticker, filing and transaction dates, insiderName, position, shares, pricePerShare, totalValue (USD), url. since_days default 30 (hard cap 180), limit default 25 (hard cap 100). SAMPLING TRAP: when the window holds more purchases than `limit`, you get the NEWEST N filings, not the whole window -- never total these rows and call it the period's insider buying. totalValue and the fallback `position` label are the two derived fields. Source: SEC EDGAR Form 4 (public domain). One ticker: ol_insider_cluster_scan or get_insider_activity.
| Name | Type | Req | Description |
|---|---|---|---|
| common_only | boolean | – | Common stock only (default true): drops derivative rows and any security title naming preferred / pfd / warrant / debenture / note. Series-named common classes ("Series A Common Stock") are kept. fal… |
| limit | integer | – | Max purchases (default 25, hard cap 100). |
| min_value | number | – | Only purchases with totalValue >= this many USD (optional). Rows whose totalValue is null -- the filed price failed the plausibility gate -- are dropped when this is set. |
| since_days | integer | – | Trailing window in days (default 30, hard cap 180). |
No output schema declared.
No examples provided.
ol_institutional_confluence Institutional Confluence ~205
Use for a one-line 'accumulating or distributing?' verdict on one ticker: latest-vs-prior-quarter 13F accumulation x insider Form 4 net buying x buy-cluster confirmation, fused on the ticker's reference 13F quarter. Returns a `verdict` (confluence_accumulation / confluence_distribution / partial_net_adding / partial_net_reducing / neutral, or insufficient_13f_coverage / insufficient_history, never coerced to neutral), plus `institutional`, `insider`, `cluster`, `coverage` and a one-line `summary`. A DERIVED verdict, not raw data: no per-fund rows. Per-fund rows: ol_ownership_changes (a ~4-quarter window, so its counts differ). Source: SEC EDGAR 13F-HR + Form 4 (Oxford Ledge derived fusion).
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol, e.g. AAPL. |
No output schema declared.
No examples provided.
ol_intrinsic_value Intrinsic Value Estimate ~223
Per-share intrinsic value from SEC EDGAR XBRL -- three textbook models: a levered-FCF DCF, a Greenwald Earnings-Power-Value, and the Graham number. Returns {summary, ticker, available, dcf_per_share, epv_per_share, graham_number, inputs, assumptions, as_of}; all three values are USD PER SHARE. `assumptions` are FIXED model constants, not per-name (10% discount, 2.5% terminal growth, 10y horizon, 21% tax). NO current price, market cap or margin of safety is returned -- fetch a price yourself and compare. A model is null when its inputs are negative or missing (null_reasons names the input), never computed as if debt-free. reason 'fetch_error' is transient: retry. The DCF is FCFE-style, not comparable to an enterprise-value DCF. Source: SEC EDGAR company-facts XBRL.
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | string | yes | Stock ticker symbol (e.g. AAPL). |
No output schema declared.
No examples provided.
ol_issuer_kpi_panel Issuer KPI Panel ~292
Tier-3 KPI PANEL for ONE issuer -- curated per-issuer metric rows (ARR, RPO/cRPO, NRR, logo retention, DAU/MAU, capacity utilization, ...) extracted from SEC filing exhibits, WITH the issuer's own metric definitions and full provenance. ABSENCE IS FIRST-CLASS: a row with value=null and is_absence=true is an answer (metric_availability says why), not a gap to fill from memory. Values are confidence-gated; needs_review rows are EXCLUDED. Optional filters: metric, period, industry. Per-issuer by design. For broad operating KPIs across 26 configured industries use ol_operating_kpis. Source: SEC 10-K/10-Q/8-K/6-K exhibits (Oxford Ledge parse); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| industry | string | – | Optional panel tag filter, e.g. enterprise_saas. |
| limit | integer | – | Max rows (default 200, hard cap 800). |
| metric | string | – | Optional metric key filter, e.g. arr, crpo, nrr. |
| period | string | – | Optional fiscal-period label, e.g. 2026-Q2. |
| ticker | string | yes | Issuer symbol (single issuer, mandatory). There is deliberately NO cross-issuer panel read -- one metric across many issuers is not an answerable question on this surface. |
No output schema declared.
No examples provided.
ol_learn_check Lesson Check ~316
Grade the learner's answer to a LEARN check. item 'self_check' with section (the check's step index) and selected_option (0-based) is graded on the server for every caller, no key needed, and returns correct, correct_option and the lesson's own explanation, which you relay as written. The module quiz (item 'quiz') and the apply task (item 'apply') are not graded over MCP yet: they answer graded: false and the lesson continues. Submit ONLY the option the learner chose, never your own pick; pass hint_used: true if they asked for the hint. A step that is not a self-check, or an option out of range, is refused (INVALID_PARAMS). Stateless: nothing is stored. Source: Oxford Ledge LEARN (authored); FREE.
| Name | Type | Req | Description |
|---|---|---|---|
| hint_used | boolean | – | True if the learner asked for the hint first. |
| item | string | yes | self_check (graded now), quiz or apply (not graded over MCP yet). |
| module_id | string | yes | Module id such as 'val-1', or its slug ('pe-ratio'), or '<path>/<slug>'. |
| options_digest | string | – | The check's options_digest from the step the learner answered. Optional; a stale one is refused, not graded. |
| section | integer | – | For self_check only: the step index of the check. |
| selected_option | integer | yes | 0-based index of the option the LEARNER chose (A = 0). |
No output schema declared.
No examples provided.
How do I install the Oxford Ledge MCP server?
Oxford Ledge is a hosted endpoint at https://www.oxfordledge.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · www.oxfordledge.com
claude mcp add --transport http com-oxfordledge-oxford-ledge 'https://www.oxfordledge.com/mcp'
What is the Oxford Ledge MCP server?
Oxford Ledge is an MCP server listed in the public MCP registry as com.oxfordledge/oxford-ledge. Ask your assistant; it reads the public record: SEC filings, 13F, insider trades, BDC loans. This page covers its hosted endpoint (https://www.oxfordledge.com/mcp).
Is the Oxford Ledge MCP server safe to use?
Oxford Ledge scores 68 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Oxford Ledge MCP server expose?
Oxford Ledge exposes 65 tools: get_13f_holdings, get_access_status, get_activist_stakes, get_anomaly_flags, get_bdc_holdings, and 60 more. Their descriptions and schemas cost roughly 16,179 tokens of context every time the server is loaded.
Does the Oxford Ledge MCP server require authentication?
No. We connected to Oxford Ledge without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Oxford Ledge MCP server still maintained?
Oxford Ledge is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the Oxford Ledge MCP server?
VerifyMCP ran 12 checks on Oxford Ledge, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about Oxford Ledge: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.