# Finance & Market Data MCP Server

Track stocks, screen equities, monitor crypto prices, and check forex rates. Real-time market data from Yahoo Finance and crypto exchanges.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nexgendata-apify/finance-mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list nexgendata-apify/finance-mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nexgendata-apify/finance-mcp-server get_stock_data

# Call a tool
npx -y @smithery/cli@latest tool call nexgendata-apify/finance-mcp-server get_stock_data '{}'
```

## Direct MCP Connection

Endpoint: `https://finance-mcp-server--nexgendata-apify.run.tools`

**Optional config:**
- `apiKey` (query) — Your Apify API token for authenticated access. Get it from https://console.apify.com/settings/integrations. Required for data retrieval; optional for server discovery and capability listing.

## Tools (5)

- `get_stock_data` — Retrieve comprehensive stock market data for individual ticker symbols from Yahoo Finance. Returns current price, intra…
- `screen_stocks` — Filter and screen stocks based on financial criteria like market cap range, sector, P/E ratio thresholds, dividend yiel…
- `get_crypto_prices` — Fetch real-time cryptocurrency prices and 24-hour market data for multiple coins. Returns current price in USD, 24h pri…
- `get_exchange_rates` — Look up current foreign exchange rates between major world currencies. Returns exchange rate, bid/ask spread, and last …
- `track_crypto_portfolio` — Monitor real-time prices and performance metrics for a portfolio of cryptocurrency holdings. Returns current price per …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nexgendata-apify/finance-mcp-server <tool-name>
```

## Resources

- `finance://asset-types` — Available data: stocks (Yahoo Finance), cryptocurrencies, and foreign exchange rates.

## Prompts (2)

- `portfolio_check` (tickers) — Get a comprehensive portfolio summary with current prices, daily changes, and market overview for a list of holdings.
- `market_overview` — Generate a broad market overview including major stock indices, crypto trends, and currency movements.