Residual Operating Income Financial Modeler

v1.0.0

Model DeductionRecommendedLocalFinance

This MCP server provides the core calculation engine tool for Enterprise Residual Operating Income Modeling. It enables AI assistants to perform multi-stage residual income forecasting, discounting, and enterprise value bridging analysis through a standardized data input interface, intelligently outputting year-by-year modeling details in Markdown format.

📖 Docs 🔗 Source

§ Quickstart

Add the following to your MCP client configuration (Cursor, Claude Desktop, etc.):

uvx automatically downloads the package and its dependencies from PyPI — no cloning, manual installation, or path configuration required.

MCP Client Configuration

{
  "mcpServers": {
    "agentladle-mcp-reoi": {
      "command": "uvx",
      "args": [
        "agentladle-mcp-reoi"
      ]
    }
  }
}

Config file locations

Cursor: Settings → MCP, or edit ~/.cursor/mcp.json
Claude Desktop: edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)

§ Tools Reference

1 tools

reoi_valuation_model

Residual Operating Income Modeling Engine. Based on base-period financial statements and forecast assumptions, it deduces future multi-stage residual income, discounts them, and outputs per-share value and modeling detail tables.

Parameter	Type	Required	Description
version	string	—	Version number, defaults to "1.0"
ticker	string	—	Stock ticker
companyName	string	—	Company name
currency	string	—	Currency unit, defaults to "CNY"
baseData	object	✓	Base financial data including totalAssets, financialAssets, totalLiabilities, financialLiabilities, preferredStock, minorityEquity, sales0, sharesOutstanding, etc.
parameters	object	✓	Core modeling parameters, including forecastYears, costOfCapitalRate (WACC), terminalGrowthRate
marketConsensus	object	—	Market consensus forecasts (optional), including revenues and eps arrays
assumptions	object	—	Forecast assumptions (optional), including salesGrowthRates and operatingMargins arrays

Returns:Markdown Modeling Table

§ Examples

Once configured, you can ask the AI directly:

Perform Residual Income Modeling

Help me model this company using the residual income model. Here is its 2025 base data (total assets 16683, financial assets 5879... equity 543). Assume revenue growth stays at 18% for 5 years, operating margin 14.5%, discount rate 8%, terminal growth 3%.

Calls the reoi_valuation_model tool with baseData, parameters, and assumptions. The tool returns a detailed Markdown formatted year-by-year modeling breakdown and suggested per-share value.