License and renewal
Your installation is licensed per month. Nothing to do on your side: when you renew, your server picks it up automatically.
How it works
- Every 6 hours the server asks the license service "is key
MMP-…still valid?" and stores the signed answer. It sends only the license key, an installation id and the product version — never your marketing data. - The dashboard and the
list_sourcestool show the state and the expiry date. - If the license service cannot be reached, your existing license keeps working until its expiry date, then for a 7-day grace period (every tool answer carries a reminder). After that the tools stop until the license is renewed; nothing is deleted.
States
| State | Meaning |
|---|---|
| VALID | all good |
| GRACE | expired less than 7 days ago — renew now, everything still works |
| EXPIRED | grace over — tools refuse until renewal |
| UNLICENSED | the key in .env is unknown or the first check hasn't happened yet |
| BLOCKED | suspended by the vendor — contact them |
Changing the key
Edit LICENSE_KEY in ~/marketing-mcp/.env, then docker compose up -d.
/setup → License → Check now forces an immediate check.
Server without internet access
Ask your vendor for a license file and paste it in /setup → License → Offline activation.
You'll receive a new file at each renewal.