Skip to content
Back to search

mcp-server

An MCP server for interacting with the Financial Datasets stock market API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/financial-datasets--mcp-server/badge.svg)](/listings/financial-datasets--mcp-server)

HTML

<a href="/listings/financial-datasets--mcp-server"><img src="/api/listings/financial-datasets--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Prerequisites

- Python 3.10 or higher - [uv](https://github.com/astral-sh/uv) package manager

Installation

1. Clone this repository:

   git clone https://github.com/financial-datasets/mcp-server
   cd mcp-server

2. If you don't have uv installed, install it:

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Windows
   curl -LsSf https://astral.sh/uv/install.ps1 | powershell

3. Install dependencies:

   # Create virtual env and activate it
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

   # Install dependencies
   uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx

4. Set up environment variables:

   # Create .env file for your API keys
   cp .env.example .env

   # Set API key in .env
   FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

5. Run the server:

   uv run server.py

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 109 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Financial Datasets MCP Server
  2. ## Introduction
  3. This is a Model Context Protocol (MCP) server that provides access to stock market data from [Financial Datasets](https://www.financialdatasets.ai/).
  4. It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.
  5. ## Available Tools
  6. This MCP server provides the following tools:
  7. - **get_income_statements**: Get income statements for a company.
  8. - **get_balance_sheets**: Get balance sheets for a company.
  9. - **get_cash_flow_statements**: Get cash flow statements for a company.
  10. - **get_current_stock_price**: Get the current / latest price of a company.
  11. - **get_historical_stock_prices**: Gets historical stock prices for a company.
  12. - **get_company_news**: Get news for a company.
  13. - **get_available_crypto_tickers**: Gets all available crypto tickers.
  14. - **get_crypto_prices**: Gets historical prices for a crypto currency.
  15. - **get_historical_crypto_prices**: Gets historical prices for a crypto currency.
  16. - **get_current_crypto_price**: Get the current / latest price of a crypto currency.
  17. ## Setup
  18. ### Prerequisites
  19. - Python 3.10 or higher
  20. - [uv](https://github.com/astral-sh/uv) package manager
  21. ### Installation
  22. 1. Clone this repository:
  23. ```bash
  24. git clone https://github.com/financial-datasets/mcp-server
  25. cd mcp-server
  26. ```
  27. 2. If you don't have uv installed, install it:
  28. ```bash
  29. # macOS/Linux
  30. curl -LsSf https://astral.sh/uv/install.sh | sh
  31. # Windows
  32. curl -LsSf https://astral.sh/uv/install.ps1 | powershell
  33. ```
  34. 3. Install dependencies:
  35. ```bash
  36. # Create virtual env and activate it
  37. uv venv
  38. source .venv/bin/activate # On Windows: .venv\Scripts\activate
  39. # Install dependencies
  40. uv add "mcp[cli]" httpx # On Windows: uv add mcp[cli] httpx
  41. ```
  42. 4. Set up environment variables:
  43. ```bash
  44. # Create .env file for your API keys
  45. cp .env.example .env
  46. # Set API key in .env
  47. FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
  48. ```
  49. 5. Run the server:
  50. ```bash
  51. uv run server.py
  52. ```
  53. ## Connecting to Claude Desktop
  54. 1. Install [Claude Desktop](https://claude.ai/desktop) if you haven't already
  55. 2. Create or edit the Claude Desktop configuration file:
  56. ```bash
  57. # macOS
  58. mkdir -p ~/Library/Application\ Support/Claude/
  59. nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  60. ```
  61. 3. Add the following configuration:
  62. ```json
  63. {
  64. "mcpServers": {
  65. "financial-datasets": {
  66. "command": "/path/to/uv",
  67. "args": [
  68. "--directory",
  69. "/absolute/path/to/financial-datasets-mcp",
  70. "run",
  71. "server.py"
  72. ]
  73. }
  74. }
  75. }
  76. ```
  77. Replace `/path/to/uv` with the result of `which uv` and `/absolute/path/to/financial-datasets-mcp` with the absolute path to this project.
  78. 4. Restart Claude Desktop
  79. 5. You should now see the financial tools available in Claude Desktop's tools menu (hammer icon)
  80. 6. Try asking Claude questions like:
  81. - "What are Apple's recent income statements?"
  82. - "Show me the current price of Tesla stock"
  83. - "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.