Earnings Calendar

Overview

This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. It focuses on companies with significant market capitalization (mid-cap and above, over $2B) that are likely to impact market movements. The skill generates organized markdown reports showing which companies are reporting earnings over the next week, grouped by date and timing (before market open, after market close, or time not announced).

Key Features:

• Uses FMP API for reliable, structured earnings data
• Filters by market cap (>$2B) to focus on market-moving companies
• Includes EPS and revenue estimates
• Multi-environment support (CLI, Desktop, Web)
• Flexible API key management
• Organized by date, timing, and market cap

Prerequisites

FMP API Key

This skill requires a Financial Modeling Prep API key.

Get Free API Key:

1. Visit: https://site.financialmodelingprep.com/developer/docs
2. Sign up for free account
3. Receive API key immediately
4. Free tier: 250 API calls/day (sufficient for weekly earnings calendar)

API Key Setup by Environment:

Claude Code (CLI):

export FMP_API_KEY="your-api-key-here"

Claude Desktop: Set environment variable in system or configure MCP server.

Claude Web: API key will be requested during skill execution (stored only for current session).

Core Workflow

Step 1: Get Current Date and Calculate Target Week

CRITICAL: Always start by obtaining the accurate current date.

Retrieve the current date and time:

• Use system date/time to get today's date
• Note: "Today's date" is provided in the environment (<env> tag)
• Calculate the target week: Next 7 days from current date

Date Range Calculation:

Current Date: [e.g., November 2, 2025]
Target Week Start: [Current Date + 1 day, e.g., November 3, 2025]
Target Week End: [Current Date + 7 days, e.g., November 9, 2025]