[EPIC] Reference Data Tools

[copyleftdev]

Depends On: #2, #1

POLYMCP-004

Goals

• Complete coverage of Reference API endpoints
• Searchable ticker lookup
• Market hours and holiday awareness
• Corporate actions (dividends, splits) access

Implement MCP tools for Polygon.io Reference Data API. Includes ticker details, market status, conditions, exchanges, news, dividends, splits, and financials. Essential for understanding market context and company information.

Acceptance Criteria

AC-1

• Given A user wants ticker details
• When The get_ticker_details tool is called with ticker=AAPL
• Then It returns name, market, locale, type, currency, description, homepage_url, branding

AC-2

• Given A user wants to search tickers
• When The search_tickers tool is called with search=Apple
• Then It returns matching tickers with name, market, type, and active status

AC-3

• Given A user wants market status
• When The get_market_status tool is called
• Then It returns current market status (open/closed/early_trading/etc) for each market

AC-4

• Given A user wants upcoming market holidays
• When The get_market_holidays tool is called
• Then It returns list of upcoming holidays with date, exchange, name, status

AC-5

• Given A user wants dividend history
• When The get_dividends tool is called with ticker=AAPL
• Then It returns dividend records with ex_date, pay_date, cash_amount, frequency

AC-6

• Given A user wants stock news
• When The get_news tool is called with ticker=TSLA
• Then It returns news articles with title, author, published_utc, article_url, tickers

Technical Context

Files:

• src/tools/reference/mod.rs
• src/tools/reference/tickers.rs
• src/tools/reference/market_status.rs
• src/tools/reference/conditions.rs
• src/tools/reference/exchanges.rs
• src/tools/reference/news.rs
• src/tools/reference/dividends.rs
• src/tools/reference/splits.rs
• src/tools/reference/financials.rs

Out of Scope

• SEC filings parsing
• Historical financials comparison

---

Source: epics/03-reference-tools.json
Content Hash: da588014b108266b