mcpField
F
FindingAlpha AI MCP Server

FindingAlpha AI MCP Server

Local
github.com/finding-alphaFinance1Updated 79w ago
Repository

About FindingAlpha AI MCP Server

FindingAlpha AI MCP Server provides tools for fundamental analysis of publicly traded stocks, including segmented revenue and congressional trading data. It is intended for stock research workflows that query by ticker or legislator name.

Key features

  1. 01Segmented revenue lookup
  2. 02Congressional trades by name
  3. 03Congressional trades by ticker

Use cases

  1. 01Review a company's revenue segments
  2. 02Look up trades associated with a legislator
  3. 03Find congressional trades for a stock ticker

MCP support

Exposes segmented-revenue and congressional-trade lookup tools to MCP clients, with queries by stock ticker or legislator name.

#findingalpha#ai#mcp#server#stock-analysis

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "findingalpha-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

    • 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.