findingalpha-ai-mcp
If you are the rightful owner of findingalpha-ai-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol server for FindingAlpha AI that provides various tools for fundamental analysis and processing for publicly traded stocks.
FindingAlpha AI MCP Server
A Model Context Protocol server for FindingAlpha AI that provides various tools for fundamental analysis and processing for public traded stocks.
Installation
Via Smithery
npx -y @smithery/cli install findingalpha-ai-mcp --client claude
Via npm
npm install findingalpha-ai-mcp
Development
Prerequisites
- Node.js 18 or higher
- npm
Setup
- Install dependencies:
npm install
- Build the server:
npm run build
- For development with auto-rebuild:
npm run watch
Testing
npm test
Usage Examples
License
MIT License - see for details.
API Endpoints
The MCP server provides the following endpoints:
-
Segmented Revenue
- Endpoint:
segmented-revenue
- Parameters:
ticker
(string) - Stock ticker symbol (e.g., AAPL) - Example:
segmented-revenue
with{ "ticker": "AAPL" }
- Endpoint:
-
Congress Trades by Name
- Endpoint:
congress-trades-by-name
- Parameters:
name
(string) - Congressman first name (e.g., nancy) - Example:
congress-trades-by-name
with{ "name": "nancy" }
- Endpoint:
-
Congress Trades by Ticker
- Endpoint:
congress-trades-by-ticker
- Parameters:
ticker
(string) - Stock ticker symbol (e.g., AAPL) - Example:
congress-trades-by-ticker
with{ "ticker": "AAPL" }
- Endpoint:
Testing
The project includes both integration tests and unit tests.
Running Tests
# Run all tests
npm test
# Run only client integration tests
npm run test:client
# Run only unit tests
npm run test:unit
Test Files
- Integration tests:
test-client.js
- Unit tests:
src/__tests__/segmented-revenue.test.ts
src/__tests__/congress-trades.test.ts