Skip to main content
Install the loyaltydog-mcp package. Your MCP client starts the loyaltydog-mcp console script.

​
Prerequisites

  • Python 3.10 or later.
  • uv (recommended). pipx and pip also work.
  • A public API key that starts with ld_live_ or ld_test_. Create the key in the LoyaltyDog dashboard. See plans and sign-up.
  • An MCP client such as Claude Desktop, Claude Code, Cursor, or Windsurf.

​
Install

uvx is the recommended way to run the server. It downloads loyaltydog-mcp and starts the console script.

​
Configure

Set these environment variables in your MCP client, or export them in your shell before a manual check. LOYALTYDOG_API_TOKEN still works as a legacy alias for LOYALTYDOG_API_KEY. A JWT app key also authenticates and does not need an API Access subscription. An ld_* key does, and each tool still needs its scope.
The server starts without LOYALTYDOG_API_KEY and still lists its tools to the client. A tool call without a key returns a clear error. Package 0.1.0 does not include phone search. That arrives in the next release. See MCP overview.

​
Sanity check

Print the version:
Running uvx loyaltydog-mcp with no arguments waits for an MCP client on stdin. Press Ctrl+C to quit. pipx run loyaltydog-mcp and loyaltydog-mcp behave the same way.

​
Upgrade

uvx loyaltydog-mcp@latest resolves the latest release and then starts the server. Press Ctrl+C to quit.

​
Next steps

Connect a client

Add the server to Claude Desktop, Claude Code, Cursor, Windsurf, or another MCP client.