landbridge-mcp

MCP server for LandBridge — manage land leads, campaigns, properties, and analytics via Claude or any MCP client.

Install

npm install -g landbridge-mcp

Authentication

On first run the server launches a device auth flow — it opens your browser so you can log in with your LandBridge account. Credentials are cached at ~/.landbridge/credentials.json.

You can also set an API key directly:

export MCP_API_KEY="your-api-key"

Usage

Stdio (default — for Claude Desktop, Claude Code, etc.)

Add to your MCP client config:

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

Or run directly:

landbridge-mcp

HTTP (for web clients and remote access)

landbridge-mcp --http

Or via environment variable:

MCP_TRANSPORT=http landbridge-mcp

The server listens on http://localhost:3100/mcp (Streamable HTTP transport with SSE support).

Endpoints:

| Method | Path | Description | |--------|------|-------------| | POST | /mcp | Send JSON-RPC messages (initialize, tool calls) | | GET | /mcp | Open SSE stream for server notifications | | DELETE | /mcp | Close a session | | GET | /health | Health check |

Sessions are managed via the mcp-session-id header.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MCP_API_KEY | — | API key (skips device auth flow) | | MCP_API_URL | https://land-tools-api-production.up.railway.app | API base URL | | MCP_WEB_URL | https://www.landbridge.app | Web app URL (for device auth) | | MCP_TRANSPORT | stdio | Transport mode: stdio or http | | MCP_PORT | 3100 | HTTP server port (HTTP mode only) |

Available Tools

Read

• list_leads — List leads with property and campaign info
• get_lead — Get detailed lead info
• search_leads — Search by name, address, APN, or phone
• list_campaigns — List campaigns with metrics
• get_campaign — Get detailed campaign info
• list_properties — List properties, filter by campaign
• search_properties — Search by address, APN, or owner
• get_kpis — KPI dashboard (current month, last month, YTD, lifetime)
• list_tasks — List tasks

Analytics

• pipeline_velocity — Stage duration, bottlenecks, fall-off rates
• campaign_roi — Marketing spend vs revenue
• deal_economics — Purchase price, selling price, profit, margins
• weighted_pipeline — Weighted pipeline value by stage probability
• stale_leads — Leads needing follow-up

Write

• update_lead — Update stage, contact info, pricing
• create_lead — Create lead from property ref ID
• delete_lead — Soft-delete a lead
• add_contact_note — Add a note to a lead
• upload_lead_image — Upload screenshot/image to a lead
• list_lead_images / delete_lead_image — Manage lead images
• edit_campaign / delete_campaign — Manage campaigns

Development

npm run dev          # stdio mode
npm run dev:http     # HTTP mode
npm run build        # compile TypeScript

License

MIT