FindingAlpha AI MCP Server

by finding-alpha

305 downloads
Not rated
GitHub

About

MCP Server for segmented revenue and congress trading

Details

Author
finding-alpha
Downloads
305
Categories
Other, AI

- MCP-based server for stock fundamental analysis.
- Provides segmented revenue data for any ticker symbol.
- Queries congress trading activities by congressman name.
- Queries congress trading activities by stock ticker.
- Built with Node.js (version 18+ required).
- Tested with integration and unit tests.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name FindingAlpha AI MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The server can be installed via Smithery using the command npx -y @smithery/cli install findingalpha-ai-mcp --client claude or via npm with npm install findingalpha-ai-mcp. After installation, build the server with npm run build and then use the provided endpoints—such as segmented-revenue, congress-trades-by-name, and congress-trades-by-ticker—by passing appropriate parameters like ticker or name.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "findingalpha ai mcp server": {
            "findingalpha-ai-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "findingalpha-ai-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "findingalpha-ai-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "findingalpha-ai-mcp",
            "--client",
            "claude"
        ]
    }
}

FindingAlpha AI MCP Server

smithery badge

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

2. Build the server:

npm run build

3. 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
- 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

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.