MCP reference

Insiderset MCP

These tools are available from the hosted server at https://mcp.insiderset.com/mcp. The REST reference is the API docs.

Connect a client

Add the remote server to Cursor, VS Code, or Claude Desktop. The client opens an OAuth consent screen, then discovers these tools. The example panel shows the mcp.json entry.

Authentication

Clients authenticate in one of two ways.

OAuth

Remote clients use OAuth 2.0 authorization code flow with PKCE. After you approve a client, manage or revoke it from Settings, then OAuth Clients.

Authorization is https://www.insiderset.com/api/oauth/authorize and the token URL is https://www.insiderset.com/api/oauth/token.

API key

Send requests to https://mcp.insiderset.com/mcp with the header Authorization: Bearer YOUR_API_KEY.

Discovery

Clients read the protected-resource metadata at https://mcp.insiderset.com/.well-known/oauth-protected-resource/mcp. It names this server, the authorization server, and the scopes mcp:read and mcp:write. The example panel shows that document.

Tools

Institutions

listInvestors

Search institutions and investors by name, company, slug, or symbol.

Returns matching slugs. query must be at least 2 characters. limit defaults to 8 and is capped at 20.

ArgumentTypeDescription
query *stringInstitution or investor name, company, slug, or symbol. At least 2 characters.
limitnumberMaximum rows to return. Defaults to 8 and is capped at 20.

fetchHoldings

Paginated 13F holdings for one institution.

One row per symbol for the latest period, sorted by portfolio percentage.

ArgumentTypeDescription
slug *stringInvestor page slug, such as warren-buffett-berkshire-hathaway.
limitnumberMaximum rows to return. Defaults to 30 and is capped at 100.
offsetnumberRows to skip. Defaults to 0.

fetchHoldingsDetails

Same holdings feed as fetchHoldings.

Same holdings and arguments as fetchHoldings.

ArgumentTypeDescription
slug *stringInvestor page slug, such as warren-buffett-berkshire-hathaway.
limitnumberMaximum rows to return. Defaults to 30 and is capped at 100.
offsetnumberRows to skip. Defaults to 0.

fetchActivity

Paginated quarter-over-quarter activity for one investor.

Newest period first. Rows with no quantity change are omitted.

ArgumentTypeDescription
slug *stringInvestor page slug, such as warren-buffett-berkshire-hathaway.
limitnumberMaximum rows to return. Defaults to 30 and is capped at 100.
offsetnumberRows to skip. Defaults to 0.

fetchOptionsActivity

Paginated 13F options for one institution.

Uses the latest period that still has options. One row per symbol and option type.

ArgumentTypeDescription
slug *stringInvestor page slug, such as warren-buffett-berkshire-hathaway.
limitnumberMaximum rows to return. Defaults to 30 and is capped at 100.
offsetnumberRows to skip. Defaults to 0.

fetchTransactions

Recent institution Form 4 trades across filers.

The same list as /institutions/form-4. A free key receives at most 10 rows. A premium key receives at most 50. This tool takes no arguments.

No arguments.

Stocks

fetchStockActivity

Current-quarter 13F share changes for one stock.

direction is all, buy, or sell and defaults to all.

ArgumentTypeDescription
stockSymbol *stringTicker symbol, such as AAPL or MSFT.
directionstringall, buy, or sell. Defaults to all.
limitnumberMaximum rows to return. Defaults to 30 and is capped at 100.
offsetnumberRows to skip. Defaults to 0.

Insights

fetchHotStocks

Hot stocks from the all-filer institution screener.

A free key receives at most 10 rows. A premium key receives at most 50.

ArgumentTypeDescription
limitnumberMaximum published rows to return. Omit it to use the tier cap.

fetchTopStocksByValue

Largest single-filer positions by market value.

Reads the all-filer institution screener.

ArgumentTypeDescription
limitnumberMaximum published rows to return. Omit it to use the tier cap.

fetchTopStocksByPercentage

Stocks ranked by aggregate portfolio weight across all institutional filers.

Reads the all-filer institution screener.

ArgumentTypeDescription
limitnumberMaximum published rows to return. Omit it to use the tier cap.

fetchMostOverweightPositions

Positions that are the largest share of one filer's book.

Reads the all-filer institution screener.

ArgumentTypeDescription
limitnumberMaximum published rows to return. Omit it to use the tier cap.

fetchSectorAllocationInsights

Sector weights across all institutional filers.

Reads the all-filer institution screener.

ArgumentTypeDescription
limitnumberMaximum published rows to return. Omit it to use the tier cap.