`dividends`

Pack: polygon-io · Endpoint: https://gateway.pipeworx.io/polygon-io/mcp

Historical and upcoming cash + stock dividends for a US-listed Polygon.io ticker: ex-date, record date, pay date, declaration date, cash amount, dividend type, frequency. Use for income analysis and dividend-capture strategies.

Parameters

Name	Type	Required
`ticker`	string	no
`ex_dividend_date`	string	no
`limit`	number	no

Example call

Arguments

{
  "ticker": "KO",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/polygon-io/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"dividends","arguments":{"ticker":"KO","limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('dividends', {
  "ticker": "KO",
  "limit": 5
});

Response shape

Field	Type	Description
`status`	string	API response status
`results`	array	Dividends data
`count`	number	Number of results
`next_url`	string	Next page URL if available

Full JSON Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "API response status"
    },
    "results": {
      "type": "array",
      "description": "Dividends data",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string",
            "description": "Ticker symbol"
          },
          "ex_dividend_date": {
            "type": "string",
            "description": "Ex-dividend date"
          },
          "record_date": {
            "type": "string",
            "description": "Record date"
          },
          "payment_date": {
            "type": "string",
            "description": "Payment date"
          },
          "declared_date": {
            "type": "string",
            "description": "Declared date"
          },
          "amount": {
            "type": "number",
            "description": "Dividend amount"
          },
          "currency": {
            "type": "string",
            "description": "Currency"
          }
        }
      }
    },
    "count": {
      "type": "number",
      "description": "Number of results"
    },
    "next_url": {
      "type": "string",
      "description": "Next page URL if available"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "polygon-io": {
      "url": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

dividends