# ReadyTrader-Stocks MCP Tool Catalog
This file is automatically generated from the tool definitions in `app/tools/`.
## Market Data
| Tool Name | Description |
| :--- | :--- |
| [`get_stock_price`](#get-stock-price) | Fetch the latest real-time stock price (bid/ask/last). |
| [`get_multiple_prices`](#get-multiple-prices) | Fetch real-time prices for multiple stock tickers simultaneously. |
| [`fetch_ohlcv`](#fetch-ohlcv) | Fetch historical OHLCV candlestick data for technical analysis. |
### `get_stock_price`
**Signature:** `get_stock_price(symbol)`
```text
Fetch the latest real-time stock price (bid/ask/last).
```
---
### `get_multiple_prices`
**Signature:** `get_multiple_prices(symbols)`
```text
Fetch real-time prices for multiple stock tickers simultaneously.
```
---
### `fetch_ohlcv`
**Signature:** `fetch_ohlcv(symbol, timeframe='1d', limit=100)`
```text
Fetch historical OHLCV candlestick data for technical analysis.
```
---
## Trading & Execution
| Tool Name | Description |
| :--- | :--- |
| [`place_market_order`](#place-market-order) | Place a market order for a stock. |
| [`place_limit_order`](#place-limit-order) | Place a limit order for a stock. |
| [`place_stock_order`](#place-stock-order) | No description. |
| [`start_brokerage_private_ws`](#start-brokerage-private-ws) | Initiate a private websocket connection for order and portfolio updates. |
### `place_market_order`
**Signature:** `place_market_order(symbol, side, amount, rationale='')`
```text
Place a market order for a stock.
```
---
### `place_limit_order`
**Signature:** `place_limit_order(symbol, side, amount, price, rationale='')`
```text
Place a limit order for a stock.
```
---
### `place_stock_order`
**Signature:** `place_stock_order(symbol, side, amount, price=0.0, order_type='market', exchange='alpaca', rationale='', audit_context='')`
---
### `start_brokerage_private_ws`
**Signature:** `start_brokerage_private_ws(brokerage)`
```text
Initiate a private websocket connection for order and portfolio updates.
```
---
## Intelligence
| Tool Name | Description |
| :--- | :--- |
| [`get_market_sentiment`](#get-market-sentiment) | Analyze current market sentiment for a stock from news and social signals. |
| [`get_market_news`](#get-market-news) | Identify key market-moving news and headlines for a specific ticker. |
| [`fetch_rss_news`](#fetch-rss-news) | Gather news headlines from a specific RSS feed URL. |
| [`get_social_sentiment`](#get-social-sentiment) | Analyze community sentiment for a stock ticker from social platforms (Reddit, Twitter). |
| [`get_financial_news`](#get-financial-news) | Retrieve detailed financial reports and official news for a ticker. |
### `get_market_sentiment`
**Signature:** `get_market_sentiment(symbol)`
```text
Analyze current market sentiment for a stock from news and social signals.
```
---
### `get_market_news`
**Signature:** `get_market_news(symbol)`
```text
Identify key market-moving news and headlines for a specific ticker.
```
---
### `fetch_rss_news`
**Signature:** `fetch_rss_news(url)`
```text
Gather news headlines from a specific RSS feed URL.
```
---
### `get_social_sentiment`
**Signature:** `get_social_sentiment(symbol)`
```text
Analyze community sentiment for a stock ticker from social platforms (Reddit, Twitter).
```
---
### `get_financial_news`
**Signature:** `get_financial_news(symbol)`
```text
Retrieve detailed financial reports and official news for a ticker.
```
---
## Research & Evaluation
| Tool Name | Description |
| :--- | :--- |
| [`run_backtest_simulation`](#run-backtest-simulation) | Run a backtest of Python strategy code against historical historical data. |
| [`run_synthetic_stress_test`](#run-synthetic-stress-test) | Run a synthetic black-swan stress test on a strategy. |
| [`get_market_regime`](#get-market-regime) | Detect the prevailing market regime (TRENDING, RANGING, VOLATILE) for a stock. |
| [`post_market_insight`](#post-market-insight) | Share a market insight or trade signal with other agents in the system. |
| [`get_latest_insights`](#get-latest-insights) | Retrieve recent high-confidence market insights for a specific symbol or all symbols. |
### `run_backtest_simulation`
**Signature:** `run_backtest_simulation(strategy_code, symbol, timeframe='1h')`
```text
Run a backtest of Python strategy code against historical historical data.
```
---
### `run_synthetic_stress_test`
**Signature:** `run_synthetic_stress_test(strategy_code, config_json='{}')`
```text
Run a synthetic black-swan stress test on a strategy.
Deterministic simulator that injects various market regimes and crashes.
```
---
### `get_market_regime`
**Signature:** `get_market_regime(symbol, timeframe='1d')`
```text
Detect the prevailing market regime (TRENDING, RANGING, VOLATILE) for a stock.
```
---
### `post_market_insight`
**Signature:** `post_market_insight(symbol, agent_id, signal, confidence, reasoning, ttl_seconds=3600)`
```text
Share a market insight or trade signal with other agents in the system.
```
---
### `get_latest_insights`
**Signature:** `get_latest_insights(symbol='')`
```text
Retrieve recent high-confidence market insights for a specific symbol or all symbols.
```
---
## Safety & Governance
| Tool Name | Description |
| :--- | :--- |
| [`validate_trade_risk`](#validate-trade-risk) | Verify if a trade complies with risk policies and current market conditions. |
| [`reset_paper_wallet`](#reset-paper-wallet) | [PAPER MODE] Clear all balances and trade history for the paper account. |
| [`deposit_paper_funds`](#deposit-paper-funds) | [PAPER MODE] Deposit virtual funds into the paper trading account. |
### `validate_trade_risk`
**Signature:** `validate_trade_risk(side, symbol, amount_usd, portfolio_value)`
```text
Verify if a trade complies with risk policies and current market conditions.
```
---
### `reset_paper_wallet`
**Signature:** `reset_paper_wallet()`
```text
[PAPER MODE] Clear all balances and trade history for the paper account.
```
---
### `deposit_paper_funds`
**Signature:** `deposit_paper_funds(asset, amount)`
```text
[PAPER MODE] Deposit virtual funds into the paper trading account.
```
---
