Alpha Insight Financial Toolkit MCP Package

This Model Context Protocol (MCP) server implementation, branded as Alpha Insight, furnishes users with diverse computational instruments for the rigorous examination and manipulation of publicly traded stock data, focusing on core financial metrics.

Deployment Instructions

Via Smithery CLI

Execute the following command to integrate this module client-side (e.g., with Claude):

bash npx -y @smithery/cli install findingalpha-ai-mcp --client claude

Via npm Registry

To incorporate this library into your Node.js project:

bash npm install findingalpha-ai-mcp

Local Development Lifecycle

Required Prerequisites

• Node.js environment (version 18 or later)
• npm package manager

Setup Procedure

1. Acquire all necessary package dependencies: bash npm install

2. Compile the source code for production readiness: bash npm run build

3. Initiate continuous development mode with automated rebuilding on file changes: bash npm run watch

Automated Verification

Run the integrated test suite:

bash npm test

Operational Scenarios

Licensing Information

This software is distributed under the terms of the MIT License. Further particulars are available in the LICENSE file.

Exposed Service Interfaces

The MCP server exposes the following callable operations:

1. Disaggregated Revenue Streams

   • Interface Path: segmented-revenue
   • Required Input: ticker (String representing the security identifier, e.g., "AAPL")
   • Invocation Example: Invoking segmented-revenue with the payload { "ticker": "AAPL" }

2. Legislator Transaction Lookup (By Individual)

   • Interface Path: congress-trades-by-name
   • Required Input: name (String specifying the legislator's given name, e.g., "nancy")
   • Invocation Example: Invoking congress-trades-by-name with the payload { "name": "nancy" }

3. Legislator Transaction Lookup (By Security)

   • Interface Path: congress-trades-by-ticker
   • Required Input: ticker (String representing the security identifier, e.g., "AAPL")
   • Invocation Example: Invoking congress-trades-by-ticker with the payload { "ticker": "AAPL" }

Quality Assurance Protocols

The repository incorporates comprehensive verification mechanisms, covering both end-to-end system interactions and granular component logic.

Executing Verification Suites

bash

Execute all verification routines

npm test

Execute only client-side interaction validations

npm run test:client

Execute only isolated logic validations (unit tests)

npm run test:unit

Verification Artifact Locations

• Client Integration Tests: test-client.js
• Unit Tests:
  • src/__tests__/segmented-revenue.test.ts
  • src/__tests__/congress-trades.test.ts