EP Ratio Screener Server

Overview

The EP Ratio Screener Server runs a fundamental stock screener based on normalized earnings yield, balance-sheet health, ROIC, earnings consistency, and yield spread versus the risk-free rate.

Connection

Add this server to your MCP client configuration.

Cursor
Bearer auth

{
  "mcpServers": {
    "ep-ratio-screener": {
      "url": "https://ep-ratio-screener-production.up.railway.app/mcp/epratioscreener"
    }
  }
}

{
  "mcpServers": {
    "ep-ratio-screener": {
      "url": "https://ep-ratio-screener-production.up.railway.app/mcp/epratioscreener",
      "headers": {
        "Authorization": "Bearer ${env:EP_RATIO_SCREENER_MCP_TOKEN}"
      }
    }
  }
}

Restart the client after changing MCP configuration. The server tools appear automatically after the connection is established.

Transport

Property	Value
Protocol	MCP over Streamable HTTP
MCP URL	`https://ep-ratio-screener-production.up.railway.app/mcp/epratioscreener`
Health URL	`https://ep-ratio-screener-production.up.railway.app/health`
MCP path	`/mcp/epratioscreener`
Request envelope	`{"request": {...}}`
Auth	Optional bearer token when enabled for the endpoint

Best-Fit Workflows

Validate runtime configuration before screening.
Score one ticker with the E/P-based decision pipeline.
Screen a batch of tickers and export CSV outputs.
Check whether the service is running in full-data or fallback mode.

Recommended Tools

config-validate
scoring-engine-score
screen-tickers

Tools

Tool	Description	Returns
`config-validate`	Validates the current EPRatio Screener configuration. Params: none	`Any`
`scoring-engine-score`	Scores a ticker using the EPRatio screener scoring engine. Params: ticker (str): ticker symbol to score	`Any`
`screen-tickers`	Run the EPRatio screening workflow and save results as CSV files. Outputs a full results CSV and a filtered passing CSV sorted by yield spread. Params: tickers: optional list of ticker symbols; use_fmp_screen: if True, overrides tickers and uses FMP’s screened universe	`dict[str, Any]`

Examples

Validate config

{
  "request": {}
}

Score one ticker

{
  "request": {
    "ticker": "MSFT"
  }
}

Screen a batch

{
  "request": {
    "tickers": [
      "MSFT",
      "AAPL",
      "JPM"
    ],
    "use_fmp_screen": false
  }
}

Notes

use_fmp_screen=true requires the optional FMP data source to be configured.
Fallback mode still supports the core scoring flow, but has less universe/enrichment coverage.

Client setup

Configure this endpoint in Cursor, Claude Desktop, or a generic MCP client.

Shared tools

Use health, result, artifact, environment, and table helper tools.

Other Servers

Dataloader

Market-data retrieval, TA-Lib indicators, and dataframe exports.

Fama-French Replicate

Official and replicated Fama-French factors plus loadings and alpha estimation.

Statistical Factor Models

Stock-Watson, complete-panel, and dynamic statistical factor extraction.

Jump Models

JumpModel and SparseJumpModel regime fitting, online prediction, and backtesting.

Wavelet Mean Reversion

Wavelet-based mean reversion analysis for financial time series.

Parallax ExtremeHurst

ExtremeHurst signal generation from OHLCV data.

Volatility Scaling Lab

Volatility targeting, EWMA volatility, Monte Carlo bands, and risk diagnostics.

​Overview

​Connection

​Transport

​Best-Fit Workflows

​Recommended Tools

​Tools

​Examples

​Validate config

​Score one ticker

​Screen a batch

​Notes