Skip to main content
The LoyaltyDog MCP server lets you call the LoyaltyDog REST API from any Model Context Protocol client. The server is an HTTP wrapper around the API, with no direct database access. It targets the production API by default.

​
What you can do

Once connected, your AI assistant can answer questions about your loyalty data:
  • “List my loyalty programs.”
  • “Find the customer with this phone number in program prog_123.”
The MCP server uses the same authentication and program isolation as the REST API. It returns only data your API key can access.

​
Architecture

The server runs as a local process started by your AI client. Your API key never leaves your machine except in outbound calls to the LoyaltyDog API.

​
Tools

loyaltydog-mcp 0.1.0 exposes 17 tools. The next package release adds a phone argument on search_customers. The list below is the 17 tools in package 0.1.0.
Five tools write data. Use an ld_test_ sandbox key while you experiment, and approve each write call in your client.
  • issue_gift_card issues a new gift card with real value. You cannot undo it.
  • redeem_gift_card deducts a real balance. You cannot undo it.
  • update_customer changes customer PII and can overwrite the points balance.
  • update_program changes program-wide settings.
  • regenerate_pass is low risk. It pushes a wallet-pass update.
  • Programs — list_programs, get_program, update_program (write)
  • Customers — search_customers (email or name), get_customer, update_customer (write)
  • Loyalty transactions — get_customer_transactions
  • Wallet passes — list_passes, get_pass, regenerate_pass (write)
  • Gift cards — list_gift_cards, get_gift_card, get_gift_card_transactions, issue_gift_card (write), redeem_gift_card (write)
  • Reporting — get_gift_card_business_report
  • System — get_system_health
search_customers matches a local phone number to the stored E.164 value using the program country.
uvx loyaltydog-mcp installs 0.1.0 today. That build searches customers by email or name. A phone argument on search_customers ships in the next package.

​
Next steps

Install the server

Install and configure the MCP server with uvx, pipx, or pip.

Connect a client

Wire up Claude Desktop, Claude Code, Cursor, or Windsurf.