Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-lighthouse) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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

When running this mcp-lighthouse server locally make sure to point to the correct build output.

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

Then restart the CLaude app. If you don't get any errors on startup, then the MCP server is working.

Authentication Walkthrough

To authenticate with Lighthouse, follow these steps:

Go to the Settings page on Lighthouse.one
Click on "Link Mobile Device" option
Click on "Copy transfer link"

Note: The URL will be in the format of a Lighthouse transfer token URL which Claude can use to authenticate your session.

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

NOTE: You can always revoke the session key from the Lighthouse dashboard.

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.

Installation

npm install

Running Locally

Build the project:

npm run build

Start the MCP server:

npm run watch

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