# Finance & Filings Data MCP server

> Provides AI agents with live stock quotes, price history, company fundamentals, and SEC EDGAR filings.

- Repository: https://github.com/projectworks007/apify-data-mcp
- Page: https://hostedmcp.org/servers/projectworks007/finance-data
- Transport: remote
- Stars: 0
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --transport http finance-data 'https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings'
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "finance-data": {
      "url": "https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "finance-data": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"finance-data","type":"http","url":"https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings"}'
```

### Codex

```sh
codex mcp add finance-data --url 'https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings'
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.finance-data]
url = "https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http finance-data 'https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings'
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "finance-data": {
      "url": "https://mcp.apify.com/?tools=highbrow_fame/yahoo-finance-quotes,highbrow_fame/sec-edgar-filings",
      "type": "http"
    }
  }
}
```

## Tools (6)

- `highbrow_fame--yahoo-finance-quotes`: This tool calls the Actor "highbrow_fame/yahoo-finance-quotes" and retrieves its output results. Actor description: Yahoo Finance quotes API: price, change, volume, P/E, market cap and dividends for stocks, ETFs and crypto for $1 per 1,000 symbols. Currencies, indexes. Price history and fundamentals on request. Unofficial Yahoo Finance API. Historical stock prices, financial data API and crypto prices API.
- `highbrow_fame--sec-edgar-filings`: This tool calls the Actor "highbrow_fame/sec-edgar-filings" and retrieves its output results. Actor description: SEC EDGAR filings by ticker, CIK or full-text search: form, dates, accession number, document links, 8-K items, and optional XBRL key financials for 10-K/10-Q. Official SEC APIs. SEC filings API and SEC EDGAR scraper.
- `get-actor-run`: Get detailed information about a specific Actor run. Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep. - summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available."). - nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=..."). - waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning. USAGE: - Use to check the status of a run started by any Actor-running tool. - Pass waitSecs > 0 to block until terminal (or until the cap elapses). USAGE EXAMPLES: - user_input: Show details of run y2h7sK3Wc - user_input: Wait for run y2h7sK3Wc to finish (read-only)
- `get-dataset-items`: Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields. USAGE: - Use when you need to read data from a dataset (all items or only selected fields). USAGE EXAMPLES: - user_input: Retrieve results from dataset abc123 - user_input: Get only metadata.url and title from dataset username~my-dataset (read-only)
- `get-key-value-store-record`: Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value. USAGE: - Use when you need to retrieve a specific record (JSON, text, or binary) from a store. USAGE EXAMPLES: - user_input: Get record INPUT from store abc123 - user_input: Get record data.json from store username~my-store (read-only)
- `abort-actor-run`: Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request. USAGE: - Use when you need to stop a run that is taking too long or misconfigured. USAGE EXAMPLES: - user_input: Abort run y2h7sK3Wc - user_input: Gracefully abort run y2h7sK3Wc

## FAQ

### What financial data can this server provide?

The server provides stock quotes, price history, company fundamentals, and SEC EDGAR company filings.
