# SEC 13F Holdings MCP — Institutional Investor Positions (`andrew_avina/sec-13f-mcp`) Actor SEC 13F Holdings MCP — Institutional Investor Positions - **URL**: https://apify.com/andrew\_avina/sec-13f-mcp.md - **Developed by:** [Andrew Avina](https://apify.com/andrew_avina) (community) - **Categories:** MCP servers, Business - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC 13F Holdings MCP — Institutional Investor Positions Wraps the SEC EDGAR 13F institutional holdings data feed. 13F filings are quarterly disclosures required of institutional investment managers who exercise investment discretion over $100 million or more in qualifying assets. These filings reveal which equities the largest funds — Berkshire Hathaway, Vanguard, BlackRock, State Street, and thousands of others — hold at the end of each calendar quarter. --- ### What is a 13F Filing? Section 13(f) of the Securities Exchange Act of 1934 requires institutional investment managers to file Form 13F with the SEC within 45 days after the end of each calendar quarter. Each filing lists: - Every covered equity security held at quarter-end - The number of shares held - The market value of those shares (in thousands of USD) - The CUSIP identifier for each security - Whether the position is held solo or jointly This actor queries the SEC EDGAR data API to surface that information programmatically. --- ### Input Parameters | Field | Type | Required | Description | |-------|------|----------|-------------| | `cik` | string | No | The Central Index Key (CIK) of the institutional filer. E.g. `"0001067983"` for Berkshire Hathaway. Leading zeros optional — the actor normalizes to 10 digits. | | `ticker` | string | No | Stock ticker symbol to search for (e.g. `"AAPL"`, `"MSFT"`). Used as a search term when `cik` is not provided. Defaults to `"AAPL"`. | | `quarter` | string | No | Target quarter in `YYYYQN` format (e.g. `"2024Q3"`). Reserved for future filtering; current implementation fetches the most recent available filing. | | `limit` | integer | No | Maximum number of records to return. Defaults to `20`. Maximum `20` per EDGAR search page. | #### Example Inputs **Get Berkshire Hathaway's most recent 13F holdings:** ```json { "cik": "0001067983", "limit": 20 } ```` **Search for all recent 13F filers that held Apple:** ```json { "ticker": "AAPL", "limit": 20 } ``` **Search for recent 13F filings with no filter:** ```json { "limit": 20 } ``` *** ### Output Schema Each record pushed to the Apify dataset contains the following fields: | Field | Type | Description | |-------|------|-------------| | `filer_name` | string | Legal name of the institutional filer (e.g. `"BERKSHIRE HATHAWAY INC"`) | | `cik` | string | 10-digit CIK of the filer | | `company_name` | string | Name of the portfolio company whose shares are held | | `ticker` | string | Stock ticker symbol of the held security | | `cusip` | string | 9-character CUSIP identifier for the security | | `shares` | number | Number of shares held at quarter-end | | `value_usd` | number | Market value in thousands of USD (as reported on the 13F) | | `period_of_report` | string | End date of the quarter to which the filing applies (YYYY-MM-DD) | #### Example Output Record ```json { "filer_name": "BERKSHIRE HATHAWAY INC", "cik": "0001067983", "company_name": "APPLE INC", "ticker": "AAPL", "cusip": "037833100", "shares": 789354960, "value_usd": 174318024, "period_of_report": "2024-09-30" } ``` *** ### Data Source All data is sourced from the SEC EDGAR public data API: - **Submissions endpoint:** `https://data.sec.gov/submissions/CIK{cik}.json` - **Filing archive:** `https://data.sec.gov/Archives/edgar/data/{cik}/{accession}/infotable.json` - **Full-text search:** `https://efts.sec.gov/LATEST/search-index` Per SEC EDGAR requirements, all requests include the `User-Agent` header identifying this actor: `SECC-MCP-Actor contact@secc.ai`. *** ### Operational Notes - **Filing lag:** 13F filings are due 45 days after quarter-end. Data for Q3 (ending September 30) is not available until mid-November. - **Value units:** The `value_usd` field reflects thousands of dollars as reported on the SEC form, matching the EDGAR infotable format. - **Fallback data:** If the SEC EDGAR API is unavailable or returns no results, the actor pushes 15 curated real-world 13F records drawn from well-known institutional filers, so downstream pipelines always receive valid output. - **CIK normalization:** CIKs are zero-padded to 10 digits internally regardless of how they are supplied. - **Rate limits:** The SEC EDGAR API enforces a limit of 10 requests per second per IP. This actor makes a small number of targeted requests and does not approach that threshold under normal use. ## Actor input object example ```json {} ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("andrew_avina/sec-13f-mcp").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("andrew_avina/sec-13f-mcp").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call andrew_avina/sec-13f-mcp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=andrew_avina/sec-13f-mcp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC 13F Holdings MCP — Institutional Investor Positions", "description": "SEC 13F Holdings MCP — Institutional Investor Positions", "version": "0.1", "x-build-id": "aP5KPd7Q5Dnc86dbD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/andrew_avina~sec-13f-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-andrew_avina-sec-13f-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/andrew_avina~sec-13f-mcp/runs": { "post": { "operationId": "runs-sync-andrew_avina-sec-13f-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/andrew_avina~sec-13f-mcp/run-sync": { "post": { "operationId": "run-sync-andrew_avina-sec-13f-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": {} }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```