{
  "markdown": "# Lemon Squeezy MCP Server\n\n![Demo GIF showing the MCP server in action](./demo.gif)\n\n## 📖 About\n**Give your AI assistant direct access to your payment and subscription data.**\n\nThis server acts as a bridge between your AI assistant (like VS Code, Claude Desktop, or any MCP-compatible client) and your Lemon Squeezy account. Instead of manually logging into dashboards, searching for orders, and copy-pasting details, you can simply ask your AI questions like:\n- *\"What was the last sale?\"*\n- *\"Is subscription #12345 still active?\"*\n- *\"Find all customers named 'Alice'\"*\n\nYour AI will query the data securely and give you an instant answer, right in your code editor.\n\n---\n\n## 🌱 Beginner Level: Getting Started\n\n**Who is this for?** You are new to CLI tools or just want to get this running quickly with minimal fuss.\n\n### 1. Prerequisites\nBefore you start, make sure you have these two things installed on your computer:\n*   **Node.js (Version 18 or higher):** This is the software that runs the server. [Download Node.js here](https://nodejs.org/).\n*   **A Lemon Squeezy Account:** You need an account to get the data. [Sign up here](https://lemonsqueezy.com).\n\n### 2. Get Your API Key\nThink of this as your password for the server.\n1.  Log in to your [Lemon Squeezy Dashboard](https://app.lemonsqueezy.com/settings/api).\n2.  Go to **Settings** -> **API**.\n3.  Click **Create API Key**.\n4.  Copy the key (it starts with `ls_...`). **Keep this safe!**\n\n### 3. Quick Installation\nOpen your terminal (Command Prompt on Windows, Terminal on Mac) and run these commands one by one:\n\n```bash\n# 1. Download the project\ngit clone https://github.com/IntrepidServicesLLC/lemonsqueezy-mcp-server.git\ncd lemonsqueezy-mcp-server\n\n# 2. Install the necessary files\nnpm install\n\n# 3. Build the server\nnpm run build\n```\n\n### 4. Connect to Your AI Editor\nThe exact steps depend on which AI editor you're using. Here are the most common:\n\n**One-copy-paste setup (Claude Desktop / Cursor / npx):**  \nAdd this to your MCP config file (e.g. `claude_desktop_config.json` or Cursor MCP settings). Replace `YOUR_KEY_HERE` with your Lemon Squeezy API key.\n\n```json\n\"mcpServers\": {\n  \"lemonsqueezy\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"lemonsqueezy-mcp-server\"],\n    \"env\": {\n      \"LEMONSQUEEZY_API_KEY\": \"YOUR_KEY_HERE\"\n    }\n  }\n}\n```\n\n*(Requires the package to be [published on npm](https://www.npmjs.com/package/lemonsqueezy-mcp-server). For local development, use the path-based config below.)*\n\n**For VS Code (local path):**\n1.  Open VS Code Settings\n2.  Go to Extensions → MCP\n3.  Add a new MCP server with:\n    *   **Command:** `node`\n    *   **Args:** `[\"/absolute/path/to/lemonsqueezy-mcp-server/dist/index.js\"]`\n    *   **Env:** `{\"LEMONSQUEEZY_API_KEY\": \"your_api_key_here\"}`\n\n**For Claude Desktop (local path):**\n1.  Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows)\n2.  Add the same configuration as above (command `node`, args with full path to `dist/index.js`)\n3.  Restart Claude Desktop\n\n**For Other MCP Clients:**\nRefer to your client's documentation for adding MCP servers. The server runs via `node /path/to/dist/index.js` with the `LEMONSQUEEZY_API_KEY` environment variable set.\n\nAfter configuring, restart your AI editor and try asking: *\"Show me my last 5 orders.\"*\n\n---\n\n## 🚀 Medium User Level: Basic Usage & Configuration\n\n**Who is this for?** You are comfortable with config files, environment variables, and want to customize how the server works.\n\n### Philosophy: \"Sensible Defaults\"\nThis server is designed to work out of the box with just **one** required setting: your `LEMONSQUEEZY_API_KEY`. Everything else is optional and has pre-configured defaults that work for 90% of users.\n\n### Configuration Options\nYou can configure the server using Environment Variables in your MCP settings or a `.env` file.\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `LEMONSQUEEZY_API_KEY` | **Required.** Your live API key. | - |\n| `LEMONSQUEEZY_TEST_API_KEY` | Optional. Use for testing without affecting real data. | - |\n| `ENABLE_RESOURCES` | Set to `true` to let the AI see \"active context\" like failed payments automatically. | `false` |\n| `POLL_FAILED_PAYMENTS` | Set to `true` to check for failed payments every few minutes. | `false` |\n\n### Common Tasks\n\n**1. Using Test Mode**\nIf you want to develop without touching real money, generate a \"Test API Key\" in Lemon Squeezy and use `LEMONSQUEEZY_TEST_API_KEY`. The server will automatically prioritize the live key if both are present, so remove the live key to force test mode.\n\n**2. Enabling Salesforce Integration (Bonus)**\nWant to sync customers to your CRM?\nAdd these variables:\n- `SALESFORCE_USERNAME`\n- `SALESFORCE_PASSWORD`\n- `SALESFORCE_TOKEN` (Security Token)\n\nThe tools for Salesforce (like `sync_customer_to_crm`) will automatically appear in your AI's toolkit.\n\n### Troubleshooting\n*   **\"Command not found\":** Ensure you ran `npm run build` after installing.\n*   **\"Authentication Error\":** Double-check your API key. Did you copy an extra space?\n*   **Logs:** The server outputs logs to the \"MCP Log\" window in your editor. Check there for specific error messages.\n\n---\n\n## 🛠️ Advanced User Level: Technical Documentation\n\n**Who is this for?** Developers, Architects, and DevOps engineers looking for deep technical details, architecture diagrams, security compliance, and deployment strategies.\n\n**Containers:** This repo has both a **Containerfile** and a **Dockerfile** with the same build. The Dockerfile exists so registries (e.g. Smithery) and CI that look for the filename `Dockerfile` can discover and build the image. You can build with Podman or Docker; see **[CONTAINERS.md](./CONTAINERS.md)** for why both exist and how to build.\n\nFor a comprehensive breakdown of the system architecture, code modules, security protocols, and enterprise deployment guides, please refer to the:\n\n👉 **[Technical Solution Design Document (TSD)](./TECHNICAL_SOLUTION_DESIGN.md)**\n\nThe TSD covers:\n*   **System Architecture & Diagrams**\n*   **Module Interflows & Data Paths**\n*   **Security & Compliance (AWS Secrets Manager, etc.)**\n*   **Deployment (Docker/OCI Containers)**\n*   **Risk Mitigation Strategies**\n",
  "bytes": 6300,
  "sha": "7472c05c2730ee904857bacc51a20548bf9a007fa67e42093b9cfb27f807d28f",
  "repo_slug": "intrepidservicesllc/lemonsqueezy-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_intrepidservicesllc_lemonsquee_e34d59c3/readme"
}