`get_earnings_calendar`

Pack: finnhub · Endpoint: https://gateway.pipeworx.io/finnhub/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_earnings_calendar for the schema, then POST the same URL with its arguments for the data.

Get upcoming and recent earnings reports. Pass symbol for one company’s earnings dates, or omit it for the whole market. Optionally filter by date range. Example: get_earnings_calendar({ symbol: “CRM”, from: “2026-01-01”, to: “2026-06-30”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`symbol`	string	no	Ticker symbol, e.g. “CRM”. Omit for the market-wide calendar.
`from`	string	no	Start date in YYYY-MM-DD format (optional)
`to`	string	no	End date in YYYY-MM-DD format (optional)
`_apiKey`	string	yes	Finnhub API key

Example call

Arguments

{
  "from": "2024-01-01",
  "to": "2024-03-31",
  "_apiKey": "your-finnhub-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/finnhub/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_earnings_calendar","arguments":{"from":"2024-01-01","to":"2024-03-31","_apiKey":"your-finnhub-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_earnings_calendar', {
  "from": "2024-01-01",
  "to": "2024-03-31",
  "_apiKey": "your-finnhub-api-key"
});

More examples

{
  "_apiKey": "your-finnhub-api-key"
}

Response shape

Always returns: count, earnings

Field	Type	Description
`count`	integer	Total number of earnings reports
`earnings`	array	List of earnings reports (max 50)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Total number of earnings reports"
    },
    "earnings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "Stock ticker symbol"
          },
          "date": {
            "type": "string",
            "description": "Earnings report date (YYYY-MM-DD)"
          },
          "quarter": {
            "type": "integer",
            "description": "Fiscal quarter"
          },
          "year": {
            "type": "integer",
            "description": "Fiscal year"
          },
          "eps_estimate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Estimated earnings per share"
          },
          "eps_actual": {
            "type": [
              "number",
              "null"
            ],
            "description": "Actual earnings per share"
          },
          "revenue_estimate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Estimated revenue"
          },
          "revenue_actual": {
            "type": [
              "number",
              "null"
            ],
            "description": "Actual revenue"
          },
          "hour": {
            "type": "string",
            "description": "Earnings announcement time"
          }
        },
        "required": [
          "symbol",
          "date",
          "quarter",
          "year",
          "eps_estimate",
          "eps_actual",
          "revenue_estimate",
          "revenue_actual",
          "hour"
        ]
      },
      "description": "List of earnings reports (max 50)"
    }
  },
  "required": [
    "count",
    "earnings"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_earnings_calendar