mcp-lighthouse

Lighthouse MCP

A Model Context Protocol (MCP) server that enables Claude to interact with your Lighthouse.one portfolio data. This integration allows you to query and analyze your crypto portfolio directly through Claude.

Features

• Authentication: Securely authenticate with Lighthouse using transfer token URLs
• Portfolio Overview: Get detailed breakdowns of your portfolio including:
  • Total portfolio value
  • Asset type distribution
  • Major holdings (≥ $1,000)
  • List of connected wallets/accounts

Installation

npm install

Running Locally

• Build the project:

npm run build

• Start the MCP server:

npm start

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "lighthouse": {
      "command": "node",
      "args": ["./dist/index.js"],
      "cwd": "/path/to/mcp-lighthouse"
    }
  }
}

Replace /path/to/mcp-lighthouse with the actual path to your project directory.

Available Commands

Once connected, you can use the following commands with Claude:

• Authenticate

  Use the authenticate command with a Lighthouse transfer token URL to log in.
  

• Get Portfolio Overview

  Use the getLighthousePortfolio command to view your current portfolio status.
  

Session Management

• The server maintains a session file (.lighthouse_session) to persist your authentication
• You only need to authenticate once unless you explicitly log out or the session expires
• Session data is stored securely on your local machine

Security Note

This MCP server runs locally on your machine and communicates directly with Lighthouse's API. Your authentication credentials are never shared with Claude or any third-party services.

Development

The project is built with TypeScript and uses the FastMCP framework for MCP server implementation. To modify or extend the functionality:

• Make changes to index.ts
• Rebuild the project: npm run build
• Restart the server

Requirements

• Node.js 16 or higher
• npm or yarn
• A Lighthouse.one account