get_ipos
Search IPO listings by ticker, listing date, or pagination cursor. Filter and retrieve initial public offering data.
Instructions
IPO listings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | No | Filter by symbol. | |
| listing_date_gte | No | Inclusive lower bound on listing date. | |
| limit | No | Max rows. Default 20. | |
| cursor | No | Pagination cursor. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/massive_mcp/tools/corporate.py:63-87 (handler)The handler function for the 'get_ipos' tool. It calls the Massive API client to fetch IPO listings with optional ticker, listing_date lower bound, limit, and pagination cursor parameters.
@mcp.tool() async def get_ipos( ticker: str | None = None, listing_date_gte: str | None = None, limit: int = 20, cursor: str | None = None, ) -> dict[str, Any]: """IPO listings. Args: ticker: Filter by symbol. listing_date_gte: Inclusive lower bound on listing date. limit: Max rows. Default 20. cursor: Pagination cursor. """ return await client.get( "/vX/reference/ipos", { "ticker": ticker, "listing_date.gte": listing_date_gte, "limit": limit, "cursor": cursor, "order": "desc", }, ) - src/massive_mcp/tools/corporate.py:63-64 (registration)The tool is registered as an MCP tool via the @mcp.tool() decorator on the get_ipos handler function.
@mcp.tool() async def get_ipos(