Ko MCP Worker

Official24 tools

by SharpLu

Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

Provides SEC filings, 13F forms, insider trades, congress activity, and macro data for AI agents.

Captured live from the server via tools/list.

get_institution_holdings

Get current stock holdings of an institutional investor (hedge fund, mutual fund, pension fund) from their latest SEC 13F filing. Returns top positions with share counts, values, and quarter-over-quarter changes.

Parameters (3)

institutionstringrequired
Institution CIK number (e.g. '1067983'), slug (e.g. 'berkshire-hathaway'), or name (e.g. 'Berkshire Hathaway') — names are resolved automatically.
pageinteger
Page number
limitinteger
Results per page

list_institutions

List top institutional investors (hedge funds, mutual funds, etc.) tracked in the SEC 13F database. Supports search by name and pagination.

Parameters (3)

searchstring
Search by institution or founder name
pageinteger
Page number
limitinteger
Results per page

get_stock_profile

Get a company's profile — sector, market cap, price, P/E ratio, 52-week range, beta, dividend yield, and other key financials.

Parameters (1)

tickerstringrequired
Stock ticker symbol (e.g. 'AAPL', 'NVDA', 'MSFT')

get_stock_holders

Get top institutional holders of a stock from SEC 13F filings. Shows which hedge funds, mutual funds, and pension funds own the most shares, with quarter-over-quarter changes.

Parameters (3)

tickerstringrequired
Stock ticker symbol (e.g. 'NVDA')
pageinteger
Page number
limitinteger
Results per page

get_stock_activity

Get institutional buying/selling activity trend for a stock over multiple quarters. Shows how many institutions are buying vs selling, net share changes, and value flows — useful for detecting accumulation or distribution patterns.

Parameters (2)

tickerstringrequired
Stock ticker symbol
quartersinteger
Number of quarters to return (default 8 = 2 years)

get_stock_price

Get historical daily stock prices (OHLC). Returns a summary by default; set series=true to get the full daily price series (for backtesting / charting).

Parameters (4)

tickerstringrequired
Stock ticker symbol
periodstring
Look-back window
seriesboolean
If true, return the full daily OHLC series (up to `limit` rows) instead of just a summary.
limitinteger
Max rows of the daily series to return when series=true.

get_insider_trades

Get insider/executive stock trades (SEC Form 4) for a company. Shows CEO, CFO, directors, and other officers buying or selling their own company's stock — a key signal for institutional investors.

Parameters (3)

tickerstringrequired
Stock ticker symbol (e.g. 'AAPL')
executive_cikstring
Filter by specific executive CIK (from list_insider_traders)
limitinteger
Max trades to return

list_insider_traders

List executives/insiders who have recently traded their company stock. Filter by role (CEO only or all executives). Useful for finding notable insider buying/selling activity across the market.

Parameters (4)

searchstring
Search by name or ticker
rolestring
Filter by role (case-insensitive): CEO, executive/officer, or all
pageinteger
limitinteger

get_congress_trades

Get stock trades made by U.S. Congress members (House & Senate). Data sourced from mandatory financial disclosures. Filter by chamber, party, state, date range, or specific stock ticker.

Parameters (8)

chamberstring
Filter by congressional chamber
partystring
Filter by party — D=Democrat, R=Republican, I=Independent
tickerstring
Filter trades by stock ticker
statestring
Filter by U.S. state (2-letter code)
searchstring
Search by member name
sortstring
Sort order — volume (most traded value), trades (most trades), recent (latest first)
pageinteger
limitinteger

get_congress_member

Get detailed trading history of a specific U.S. Congress member. Shows individual trades with transaction types, amounts, and disclosure dates.

Parameters (3)

memberstringrequired
Member slug (e.g. 'nancy-pelosi', 'dan-crenshaw'). Use get_congress_trades or search to find exact slugs.
pageinteger
limitinteger

search

Search across institutions, stocks, and insider traders in the ko.io SEC database. Use this first when you have a name but need the CIK number, ticker, or slug to use with other tools.

Parameters (2)

querystringrequired
Search query — company name, ticker, person name, or institution name (min 2 characters)
limitinteger
Max results per category

get_form144_notices

Get SEC Form 144 filings — notices of proposed sale of restricted/controlled securities by insiders. Filed before selling, these signal upcoming insider sales. Complements Form 4 (post-trade) with pre-trade intent.

Parameters (3)

tickerstring
Filter by stock ticker (e.g. 'AAPL')
insider_cikstring
Filter by insider's CIK number
limitinteger
Max notices to return

sec_list_filings

List an entity's SEC filings from EDGAR (most recent first), each with its accession number. Provide the company's CIK (use search or get_stock_profile to find it). Returns accession numbers to pass to sec_get_filing_index / sec_get_filing_document.

Parameters (5)

cikstringrequired
Company CIK number (e.g. '320193' for Apple)
form_typestring
Exact SEC form filter, e.g. '10-K', '13F-HR', '8-K'
fromstring
Earliest filing date, ISO YYYY-MM-DD
tostring
Latest filing date, ISO YYYY-MM-DD
limitinteger
Max filings to return

sec_get_filing_index

Enumerate every file in a single SEC filing (primary document, exhibits, images, XBRL, the full .txt submission). Pass a file name from here to sec_get_filing_document.

Parameters (2)

cikstringrequired
Company CIK number
accession_nostringrequired
Accession number, e.g. '0000320193-23-000106'

sec_get_filing_document

Get a source document from a SEC filing, served by ko.io. Returns a ko.io LINK to the rendered document (open in a browser) plus, optionally, an extracted text excerpt. Never returns the whole file — for full content, open the link or request a specific section.

Parameters (4)

cikstringrequired
Company CIK number
accession_nostringrequired
Accession number, e.g. '0000320193-23-000106'
filestring
File name within the filing (from sec_get_filing_index). Omit for the primary document.
include_excerptboolean
Include a text excerpt (first ~6000 chars) in the response

get_stock_financials

Get quarterly or annual financial statements for a company (revenue, net income, EPS, margins, cash flow, debt ratios) from SEC 10-K/10-Q filings.

Parameters (3)

tickerstringrequired
Stock ticker symbol (e.g. 'AAPL', 'MSFT')
period_typestring
Period type — quarterly (10-Q) or annual (10-K)
limitinteger
Number of periods to return (default 8)

get_treasury_yields

Get U.S. Treasury yield curve data — daily yields for maturities from 1-month to 30-year. Essential for understanding interest rate environment and yield curve shape.

Parameters (1)

daysinteger
Number of days of history (default 30)

get_fed_rates

Get Federal Reserve interest rates — Fed Funds Rate, SOFR, Prime Rate, Discount Rate, and Treasury yields. Key indicators for monetary policy.

Parameters (1)

daysinteger
Number of days of history (default 30)

get_economic_indicators

Get U.S. economic indicators from BLS — CPI (inflation), PPI (producer prices), Non-farm Payrolls (employment), Unemployment Rate, JOLTS. Filter by category.

Parameters (2)

categorystring
Category (case-insensitive): cpi/inflation, ppi, nfp/payrolls, unemployment, jolts, or all
daysinteger
Number of days of history (default 365)

get_ftd_data

Get SEC Failures-to-Deliver (FTD) data for a stock. High FTD quantities may indicate naked short selling or settlement issues.

Parameters (2)

tickerstringrequired
Stock ticker symbol (e.g. 'GME', 'TSLA')
daysinteger
Number of days of history (default 90)

get_financial_stress

Get the OFR Financial Stress Index — a daily indicator of stress in global financial markets. Values above 0 indicate above-average stress.

Parameters (1)

daysinteger
Number of days of history (default 365)

get_crypto_exposure

Get a market-wide summary of institutional exposure to US spot crypto ETFs (Bitcoin ETF complex: IBIT, FBTC, GBTC, etc.) from the latest quarter of SEC 13F filings. Returns total institutional USD held, quarter-over-quarter change, and a per-ETF breakdown (holders, USD, QoQ).

No parameters.

get_crypto_holders

List institutional investors holding US spot crypto ETFs (Bitcoin ETF complex), ranked by total USD held, from the latest quarter of SEC 13F filings. Optionally filter to holders of a specific ETF via the `product` parameter (e.g. 'IBIT').

Parameters (3)

productstring
Filter to holders of a specific spot crypto ETF ticker, e.g. 'IBIT', 'FBTC', 'GBTC'.
pageinteger
Page number
limitinteger
Results per page

get_crypto_holder

Get one institution's spot crypto-ETF holdings (Bitcoin ETF complex): its per-ETF positions in the latest filed quarter (shares, USD, QoQ change, action) plus its rank among all crypto-ETF holders. Use a CIK number (find it with get_crypto_holders or the search tool).

Parameters (1)

institutionstringrequired
Institution CIK number (e.g. '1512857' for Brevan Howard) or name (e.g. 'BlackRock').

Install

Tools (24)

get_institution_holdingslist_institutionsget_stock_profileget_stock_holdersget_stock_activityget_stock_priceget_insider_tradeslist_insider_traders

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.ko.io/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ko-mcp-worker": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ko.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.