# MCP tools & prompts

Seven tools and three prompts. Tool results are JSON; articles include the title, url, source, time, symbols, and AI summary.

## `latest_news`

Latest stock news for one or more tickers.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `symbols` | string[] | **required** | Stock tickers such as `NVDA` or `AAPL`. |
| `hours` | integer | `24` | Look-back window, 1–720. |
| `limit` | integer | `10` | Articles to return, 1–50. |

Try: “What's the latest news on NVDA and AAPL?”

## `search_news`

Filtered and full-text search across the archive, with cursor paging.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `query_text` | string |  | Words to match in title and summary. Quote phrases: `"rate cut"`. |
| `tickers` | string[] |  | Matches articles tagged with any of the tickers. |
| `category` | enum |  | `stocks`. |
| `type` | enum |  | Stock articles use the same three types as Vantafin: `news` (stock news), `press_release` or `legal`. `stock_news` returns stock news only. |
| `sources` | string[] |  | Publisher domains, e.g. `businesswire.com`. |
| `since / until` | string |  | ISO 8601 timestamp or `YYYY-MM-DD`. |
| `sort` | enum | `published_desc` | `published_desc`, `published_asc` or `relevance`. |
| `limit` | integer | `10` | 1–50. |
| `cursor` | string |  | `next_cursor` from the previous call. |

Try: “Find press releases about semiconductor stocks from last week.”

## `get_article`

One article by id with its summary, entities and, for press releases, the full text.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `article_id` | string | **required** | An id such as `art_9f2c1d7e4b8a6035`. |
| `include_body` | boolean | `true` | Include full text (capped at 20,000 characters). |

Try: “Read the full Microsoft buyback press release and list the key numbers.”

## `market_brief`

Latest stories per category plus the most-covered symbols, in one call.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `hours` | integer | `12` | Look-back window, 1–72. |
| `per_category` | integer | `5` | Stories per category, 1–15. |
| `categories` | enum[] | `stocks` | Coverage is `stocks`. |

Try: “Give me a briefing on what moved markets overnight.”

## `get_trending`

Symbols with the most news in the last hour, day or week.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `window` | enum | `24h` | `1h`, `24h` or `7d`. |
| `kind` | enum | `ticker` | `ticker` ranks stock tickers. |
| `category` | enum |  | Only count one category. |
| `limit` | integer | `20` | 1–50. |

Try: “Which stocks are getting the most coverage today?”

## `list_sources`

Publishers we cover, with 30-day article counts.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `category` | enum |  | Only sources that published in this category. |
| `type` | enum |  | Only sources of this type: `news`, `stock_news`, `press_release` or `legal`. |

Try: “Which press-release wires do you cover?”

## `list_tickers`

Every ticker tagged on at least one article, with a total and counts for news, press releases, and legal.

| Argument | Type | Default | Description |
| --- | --- | --- | --- |
| `category` | enum |  | Only tickers with an article in this category. |
| `type` | enum |  | Only tickers with an article of this type: `news`, `stock_news`, `press_release` or `legal`. |

Try: “Which tickers do you have news for?”

## Prompts

Prompts are templates your app can offer as slash commands or shortcuts.

| Prompt | Arguments | What it does |
| --- | --- | --- |
| `morning_briefing` | focus (optional) | A themed briefing of the overnight news cycle, with the headlines that drove unusual volume. |
| `watchlist_news` | symbols | One line per symbol: what happened, and the likely catalysts. |
| `ticker_deep_dive` | symbol, days (optional) | The news narrative for one stock over time, with key dated events and citations. |

## Errors

Bad arguments come back as tool errors with a readable message (for example “at most 10 symbols in total”), so the model can correct itself. Authentication failures are HTTP `401`; plans without MCP get `403`; bursts over 20 requests per second get `429`.