findingalpha-ai-mcp

findingalpha-ai-mcp

3.2

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

  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 for details.

API Endpoints

The MCP server provides the following endpoints:

  1. Segmented Revenue

    • Endpoint: segmented-revenue
    • Parameters: ticker (string) - Stock ticker symbol (e.g., AAPL)
    • Example: segmented-revenue with { "ticker": "AAPL" }
  2. 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" }
  3. 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" }

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

Related MCP Servers

View all finance servers →