Lighthouse

An MCP server for chatting with your Lighthouse portfolio

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "l3wi-mcp-lighthouse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lighthouse"
      ]
    }
  }
}

This MCP server lets Claude securely access and analyze your Lighthouse.one portfolio data from your local machine. With it, you can authenticate, view a portfolio overview, inspect assets, review transaction history, and analyze performance using natural language queries.

How to use

You connect the Lighthouse MCP server to Claude Desktop or another MCP client to enable natural language queries over your Lighthouse.one data. After you authenticate once, you can ask questions like how your portfolio is performing, which assets are present, or for a breakdown of holdings. Use the provided commands to authenticate, list portfolios, get overviews, fetch yield data, and review performance over time.

How to install

Prerequisites you need before installing the server are Node.js 16 or higher and npm or yarn.

npm install

npm run build

Additional notes

Security: This MCP server runs locally on your machine and communicates directly with Lighthouse's API. Your authentication credentials are never shared with Claude or third parties. You can revoke the session key from the Lighthouse dashboard at any time.

Session management: The server stores a session file (.lighthouse_session) to persist your authentication. You only need to authenticate once unless you log out or the session expires. Session data remains on your machine.

Authentication walkthrough: To obtain the transfer link, open Lighthouse Settings and use Link Mobile Device, then Copy transfer link. Claude will use this Lighthouse transfer token URL to authenticate your session.

Running locally: After building, you can configure Claude to start the MCP server using one of the provided commands. You will typically choose the npx option for quick startup or a direct Node runtime for a local build.

Authentication and usage commands

Once connected, use these commands to interact with your Lighthouse data through Claude:

Session and security reminders

Keep your local authentication secure and regularly review authorized devices in Lighthouse. The MCP server does not transmit credentials to Claude or external services.

Available tools

authenticate

Authenticate your Lighthouse account by providing the Lighthouse transfer token URL to establish a session.

listPortfolios

Retrieve all portfolios and their total values connected to your Lighthouse account.

getLighthousePortfolio

Fetch a detailed status and breakdown of your current portfolio, including value, asset distribution, and top holdings.

getLighthouseYieldData

Obtain yield information for your Lighthouse portfolio to understand returns.

getLighthousePerformanceData

Analyze portfolio performance over time with historical data and trends.