README.md•2.96 kB
# Financial Datasets MCP Server
A financial data provider MCP server built with [Smithery CLI](https://smithery.ai/docs/getting_started/quickstart_build_python)
## Features
This MCP server provides tools for accessing financial data including:
- Income statements
- Balance sheets
- Cash flow statements
- Current stock prices
- Historical stock prices
- Company news
- SEC filings
- Cryptocurrency prices and information
## Prerequisites
- **Smithery API key**: Get yours at [smithery.ai/account/api-keys](https://smithery.ai/account/api-keys)
- **Financial Datasets API key** (optional): Can be provided through:
- Environment variable: `FINANCIAL_DATASETS_API_KEY`
- Session configuration when connecting to the server
## Configuration
The server accepts the following configuration parameters:
- `api_key`: Your Financial Datasets API key (optional)
- `pirate_mode`: Speak like a pirate (for fun, default: false)
## Getting Started
1. Set up your environment:
```bash
# Optional: Create a .env file with your API key
echo "FINANCIAL_DATASETS_API_KEY=your_api_key_here" > .env
```
2. Run the server:
```bash
uv run dev
```
3. Test interactively:
```bash
uv run playground
```
## Available Tools
### Financial Data Retrieval
- `get_income_statements`: Get income statements for a company
- `get_balance_sheets`: Get balance sheets for a company
- `get_cash_flow_statements`: Get cash flow statements for a company
- `get_current_stock_price`: Get the current/latest price of a company
- `get_historical_stock_prices`: Get historical stock prices for a company
- `get_company_news`: Get news for a company
- `get_sec_filings`: Get SEC filings for a company
### Cryptocurrency Data
- `get_available_crypto_tickers`: Get all available crypto tickers
- `get_historical_crypto_prices`: Get historical prices for a cryptocurrency
- `get_current_crypto_price`: Get the current/latest price of a cryptocurrency
### Financial Analysis
- `analyze_financial_ratios`: Comprehensive financial ratio analysis including:
- **Profitability ratios**: ROE, ROA, profit margin, operating margin
- **Valuation ratios**: P/E, P/B, P/S ratios
- **Liquidity ratios**: Current ratio, quick ratio
- **Solvency ratios**: Debt-to-equity, interest coverage
- **Analysis**: Contextual interpretation of each ratio
- **Summary**: Overall financial health assessment
## Development
Your server code is in `src/hello_server/server.py`. Add or update your server capabilities there.
## Deploy
Ready to deploy? Push your code to GitHub and deploy to Smithery:
1. Create a new repository at [github.com/new](https://github.com/new)
2. Initialize git and push to GitHub:
```bash
git add .
git commit -m "Financial Datasets MCP Server"
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO.git
git push -u origin main
```
3. Deploy your server to Smithery at [smithery.ai/new](https://smithery.ai/new)