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

1. Install dependencies:

npm install

1. Build the server:

npm run build

1. For development with auto-rebuild:

npm run watch

Testing

npm test

Usage Examples

License

MIT License - see LICENSE for details.

API Endpoints

The MCP server provides the following endpoints:

1. Segmented Revenue
2. Endpoint: segmented-revenue
3. Parameters: ticker (string) - Stock ticker symbol (e.g., AAPL)

4. Example: segmented-revenue with { "ticker": "AAPL" }

5. Congress Trades by Name

6. Endpoint: congress-trades-by-name
7. Parameters: name (string) - Congressman first name (e.g., nancy)

8. Example: congress-trades-by-name with { "name": "nancy" }

9. Congress Trades by Ticker

10. Endpoint: congress-trades-by-ticker
11. Parameters: ticker (string) - Stock ticker symbol (e.g., AAPL)
12. Example: congress-trades-by-ticker with { "ticker": "AAPL" }

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