agentladle-mcp-reoi

AgentLadle MCP REOI

中文 | English

A Model Context Protocol (MCP) server for Residual Operating Income (REOI) Valuation, built with Python and FastMCP.

📈 Financial Data & Valuation Engine — A professional quantitative analysis tool for Residual Operating Income modeling.

It enables AI assistants (like Claude, Cursor, etc.) to perform multi-stage residual income projections, discounting, and enterprise value bridging analysis via standardized data input interfaces.

Features

• 1 Professional MCP Tool providing comprehensive financial valuation capabilities.
• Standardized REOI Framework, incorporating base period analysis, forecast period discounting, and terminal value estimation.
• Multi-stage Profit Forecasting, allowing independent revenue growth rates and operating margins configuration for each year.
• Smart Markdown Formatting, returning not only precise valuation figures but also built-in markdown tables for elegant rendering inside LLM clients.
• Zero Configuration Installation — Add one line to your MCP client without cloning or manual setup.
• Pure Python, cross-platform (Windows / macOS / Linux).

Prerequisites

• Python 3.10+ — Download Python
• uv — Install uv

Tip: After installing uv, restart your terminal and MCP client (e.g., Claude Desktop) to ensure the uv command is recognized.

Quick Start

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

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

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

Alternative: pip install

If you prefer managing the environment yourself:

pip install agentladle-mcp-reoi

Then configure:

{
  "mcpServers": {
    "agentladle-mcp-reoi": {
      "command": "agentladle-mcp-reoi"
    }
  }
}

Alternative: Run from Source (Local Dev)

Clone the repository and run directly:

git clone https://github.com/agentladle/mcp-reoi.git

Configure your MCP client:

{
  "mcpServers": {
    "agentladle-mcp-reoi": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-reoi", "agentladle-mcp-reoi"]
    }
  }
}

Replace /path/to/mcp-reoi with the actual path to the cloned repository.

Tool List

Tool 1: reoi_valuation_model

Calculates enterprise equity value and suggested value per share by taking base period financial data and future forecast assumptions.

Parameter List (request object)

baseData object

parameters object

marketConsensus object (Optional)

assumptions object (Optional)

Data Flow

Model Input (Financials & Assumptions)
        │
        ▼
   Input Validation
        │
        ├── 1. Derive Base Net Operating Assets (NOA) and Asset Turnover
        │
        ├── 2. Forecast Period Projection (Compute sales, OI, ending NOA, residual income)
        │
        ├── 3. Terminal Value Calculation (Compute terminal value and discount to present)
        │
        └── 4. Value Bridging (Core operating value + Financial Assets - Liabilities - Minority Equity)
        │
        ▼
Markdown Detailed Output (Value per share, Data Tables)

Tech Stack

License

MIT