home / mcp / lsd mcp server

LSD MCP Server

LSD Model Context Protocol

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "lsd-so-lsd-mcp": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "install",
        "app.py"
      ],
      "env": {
        "LSD_USER": "<your_email_here>",
        "LSD_API_KEY": "<api_key_from_your_profile_page>"
      }
    }
  }
}

You run an MCP server that lets Claude access live web data through LSD. This setup lets you connect Claude to internet-facing data sources via a simple, scriptable bridge, so you can query, retrieve, and process information in real time while keeping your credentials secure locally.

How to use

After you start the LSD MCP server, you connect an MCP client (such as Claude Desktop) to the local MCP endpoint. Use the client to issue queries that leverage LSD SQL to access web data as if you were querying a database. You can request data from web pages, run scans, and retrieve information with declarative LSD queries. Use the client’s MCP connection features to route questions through the LSD MCP server and handle responses as structured data.

How to install

Prerequisites you need on your machine are Python and uv installed. You also need the Claude desktop app or another MCP client to connect to the server.

1. Clone the LSD MCP repository and enter the project folder.

$ git clone https://github.com/lsd-so/lsd-mcp.git
$ cd lsd-mcp

2. Create and populate the environment file with your LSD credentials.

LSD_USER=<your_email_here>
LSD_API_KEY=<api_key_from_your_profile_page>

3. Start the MCP server using the standard startup command shown here. This command runs the MCP server through uv and installs the app via the MCP framework.

uv run mcp install app.py

Note: If you need to adjust the path for the uv executable later, update the claude_desktop_config.json file to point to the full path of uv before restarting Claude Desktop.

Additional sections

Configuration notes are embedded in the setup steps above. If you encounter issues starting the MCP server, verify that your environment file is correctly populated and that the uv command is accessible from your shell. Common problems include missing executables for database tooling or incorrect paths to uv in the configuration. For troubleshooting, ensure you have PostgreSQL installed if you see a pg_config error, and adjust the command path in claude_desktop_config.json if needed.

Security and access: keep your LSD API key secret and do not expose it in shared environments. Use the local environment variables to store credentials securely on your machine.

Examples and testing: once the server is running, you can issue LSD SQL-like queries through the MCP client to fetch data from web sources, using the SCAN capability to retrieve documentation or data from supported endpoints.

Available tools

LSD SQL

A DSL for querying live web data as if it were a PostgreSQL-like database, enabling just-in-time data retrieval from web sources.

SCAN

A mechanism to fetch documentation or documentation-like data from the language's resources via the MCP bridge.