Lumenx MCP

🚀 LumenX-MCP: The Legal Spend Intelligence Server

Unlock the full potential of your legal spend data. LumenX-MCP is an open-source, enterprise-grade server that unifies your legal and financial data from any source, providing a single, intelligent point of access for AI agents and analytics platforms. Built on the Model Context Protocol (MCP), this server allows you to seamlessly connect to e-billing platforms, ERP systems, databases, and even local files, transforming fragmented data into a queryable, actionable resource.

🚀 Quick Start

Prerequisites

• Python 3.10 or higher
• Docker (recommended for the easiest setup)
• Access to one or more of the supported data sources

📦 Installation

Using Docker (Recommended)

For a consistent and isolated environment, we recommend using Docker.

1. Build the Docker image:

docker build -t legal-spend-mcp .

2. Run the container:

docker run -d --name legal-spend-mcp -v ./.env:/app/.env -v ./data:/app/data legal-spend-mcp

From Source

If you prefer to install from source, you have two options:

1. Editable install (recommended for developers): This uses the pyproject.toml file and is the best option if you plan to contribute.

# Clone the repository
git clone https://github.com/DatSciX-CEO/LumenX-MCP.git
cd LumenX-MCP

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in editable mode with dev dependencies
pip install -e .[dev]

2. Using requirements.txt: This is a standard way to install dependencies for deployment or general use.

# After cloning and activating your virtual environment
pip install -r requirements.txt

Configuration

1. Create your environment file:

cp .env.template .env

2. Enable your data sources: Edit the .env file to enable the platforms you use and provide your credentials. The server will only initialize the sources you enable.

# Enable the data sources you want to use
LEGALTRACKER_ENABLED=true
LEGALTRACKER_API_KEY=your_api_key_here
LEGALTRACKER_BASE_URL=https://api.legaltracker.com

# For instance-specific URLs, be sure to use your organization's endpoint
ONIT_ENABLED=true
ONIT_API_KEY=your_api_key
ONIT_BASE_URL=https://<your-company>.onit.com

Launch the Server

Once configured, you can start the server with:

python -m legal_spend_mcp.server

For more detailed instructions, see the QUICKSTART.md guide.

✨ Features

• Unified Data Access: Connect to multiple data sources simultaneously, from LegalTracker and SAP to local CSV files.
• Comprehensive Analytics: Get instant insights with tools for spend summaries, vendor performance analysis, and budget variance.
• Extensible by Design: A modular architecture makes it easy to add new data source connectors and expand capabilities.
• AI-Ready: Built for the future of legal tech, enabling powerful integrations with AI agents and large language models.
• High Performance: A fully asynchronous architecture ensures that data retrieval is fast and efficient.
• Enterprise-Grade: Robust, validatable configuration and full Docker support for reliable, containerized deployments.

💻 Usage Examples

Basic Usage

You can use the provided tools to access and analyze legal spend data. For example, to get the legal spend summary:

# Assume you have a client connected to the LumenX-MCP server
client = ...
summary = client.get_legal_spend_summary(filter=...)

Advanced Usage

For more complex analysis, you can combine multiple tools. For instance, to analyze vendor performance and compare it with budget:

# Assume you have a client connected to the LumenX-MCP server
client = ...
vendor_performance = client.get_vendor_performance(vendor_id=...)
budget_vs_actual = client.get_budget_vs_actual()
# Further analysis can be done here

📚 Documentation

Available Tools & Resources

The server exposes a rich set of tools and resources for any MCP-compatible client.

Tools (Callable Functions)

• get_legal_spend_summary: Get aggregated spend data with powerful filtering.
• get_vendor_performance: Analyze performance metrics for a specific vendor.
• get_budget_vs_actual: Compare actual spending against budgeted amounts.
• search_legal_transactions: Perform a full-text search for specific transactions.

Resources (Data Objects)

• legal_vendors: A comprehensive list of all vendors across all data sources.
• data_sources: The status and configuration of all connected data sources.
• spend_categories: All available spend categories, practice areas, and departments.
• spend_overview/recent: A high-level overview of spend activity from the last 30 days.

Supported Data Sources

LumenX-MCP is built to be a central hub for all your legal data.

E-Billing & Matter Management

• LegalTracker: Real-time invoice and matter data.
• SimpleLegal: (Planned) Integration with SimpleLegal's API.
• Brightflag: (Planned) Integration with Brightflag's API.
• TyMetrix 360: (Planned) Integration with TyMetrix 360's API.
• Onit: (Planned) Integration with Onit's API.

ERP Systems

• SAP: Via SQL Server database connection.
• Oracle: Via Oracle database connection.
• Microsoft Dynamics 365: (Planned) Integration with Dynamics 365's API.
• NetSuite: (Planned) Integration with NetSuite's API.

Databases

• PostgreSQL: Full support for legal spend tables.
• SQL Server: Compatible with SAP and other ERP systems.
• Oracle: Enterprise financial system integration.

File Imports

• CSV: Standard comma-separated values.
• Excel: .xlsx files with configurable sheet names.

🤝 Contributing

We welcome contributions of all kinds, from bug fixes to new data source connectors! Please see our CONTRIBUTING.md guide for details on how to get started.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.