# Massive MCP for AI Agents AI Agent Connect > Massive MCP for AI Agents. Get historical stock dividend data and distribution records directly in your chat. This Connector lets your agent pull years of payout history, filter by frequency or ex-dividend dates, and identify special distributions for thousands of tickers. It's built for anyone who needs to do deep equity research or build financial models without manual data entry. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_rc42LBCIrmjKNzjGUWLP0bo1E4V4wqqMNFxfT1kD/ai-agent-connect - **Tags:** dividends, stock-market, financial-data, investing, equity-research ## Description Imagine you're trying to figure out a company's payout history. Usually, that means jumping between multiple financial websites, copying dates into a spreadsheet, and trying to spot the difference between a regular quarterly payment and a one-off special dividend. This Connector changes that by letting your AI agent do the heavy lifting. You just ask for the data, and it pulls the records for you. You can look at a ticker and see every distribution it's made over the years, sorted by date or specific payout types. If you're building a model and need to see how often a company pays out, you can filter by frequency or look for irregular payments that might signal a shift in strategy. Because Vinkius hosts this Connector, you can plug it into your existing setup and start querying financial data immediately. It's about getting to the numbers faster so you can spend more time actually analyzing what they mean for your portfolio or your clients. ## Tools ### list_dividends Get historical cash dividends for a specific ticker. This tool pulls the full payout history so you can see every distribution a company has made. ## Prompt Examples **Prompt:** ``` List historical dividends for ticker 'AAPL'. ``` **Response:** ``` I've pulled the dividend history for Apple Inc. (AAPL). Here are the recent distributions: | Ex-Dividend Date | Amount | Type | | :--- | :--- | :--- | | 2024-05-10 | $0.25 | Recurring | | 2023-11-17 | $0.24 | Recurring | Would you like to see the full history of all payouts for this ticker? ``` **Prompt:** ``` Show me special dividends for 'MSFT' sorted by date. ``` **Response:** ``` Searching for special distributions for Microsoft (MSFT)... I found a notable special dividend record from 2004-11-15 for $3.00. There are no other recent distributions flagged as 'special' in the database. ``` **Prompt:** ``` Find all dividends for 'KO' with a frequency of 4. ``` **Response:** ``` Querying quarterly dividends for Coca-Cola (KO)... I've found a consistent history of quarterly distributions (frequency: 4). **Recent Payouts:** * $0.48 (Most Recent) * $0.47 (Previous) Would you like to see the growth trend over the last 5 years? ``` ## Capabilities ### Fetch full cash distribution records Get the entire payout history for any supported stock ticker in one go. ### Filter by payout frequency Narrow down results to only show annual, quarterly, or other specific payment schedules. ### Identify special distributions Distinguish between recurring payments and one-time special or irregular dividends. ### Sort large datasets Organize up to 5000 records by date or other criteria for easier analysis. ### Build investment reports Use historical trends to create accurate yield growth and payout models. ## Use Cases ### Checking yield growth An analyst asks for the last 10 years of dividends for a ticker to see how the payout has increased over time. ### Finding special dividends An investor wants to know if a company ever paid a one-time special distribution in the past to check for anomalies. ### Building a portfolio model A user asks for all quarterly dividends for a specific stock to calculate a projected annual yield for a spreadsheet. ### Automating research A developer asks the agent to find all dividends for a list of tickers to populate a custom research dashboard. ## Benefits - Stop manually scraping data from websites. Use list_dividends to get years of payout history in a single request. - Identify special payouts quickly. See which distributions were one-offs versus recurring payments to understand company behavior. - Filter by specific dates or frequencies. Narrow down results to only the quarterly or annual payments that matter for your model. - Handle large datasets easily. Sort and limit results up to 5000 records to build precise financial models without hitting limits. - Build better investment reports. Use the data to show dividend growth trends over the last five years directly in your chat. ## How It Works The bottom line is you get clean, structured dividend data in your chat window without leaving your workspace. 1. Get your API key from the Massive platform. 2. Connect the Connector through the Vinkius dashboard. 3. Ask your AI client to pull dividend history for a specific ticker. ## Frequently Asked Questions **Can Massive MCP find special one-time dividends?** Yes, it identifies distributions flagged as special, supplemental, or irregular. This helps you see if a payout was a one-off event or part of a regular schedule. **How many dividend records can I pull at once?** You can pull up to 5000 records in a single query. This is plenty for looking at a long history of payouts for a single ticker or several smaller ones. **Does Massive MCP provide real-time stock prices?** No, this Connector focuses on historical dividend data and distribution records. You'll need a different tool for live price tracking. **Can I filter dividends by how often they are paid?** Yes, you can filter by frequency, such as quarterly or annual payments. This makes it easy to see only the regular payouts you're tracking. **Is the data from Massive MCP accurate for research?** It pulls directly from the Massive API, which is a standard source for financial distribution records. It's designed for use in equity research and financial modeling. **Can I filter dividends by a specific date?** Yes. You can use the `ex_dividend_date` parameter in the `list_dividends` tool to find distributions occurring on or after a specific YYYY-MM-DD date. **What types of dividend distributions can I identify?** The `list_dividends` tool supports filtering by `distribution_type`, including 'recurring', 'special', 'supplemental', 'irregular', and 'unknown'. **How many dividend records can I retrieve at once?** By default, the `list_dividends` tool returns 100 results, but you can increase the `limit` parameter up to a maximum of 5000 records per query.