Frequently asked questions

Getting started

Do I need both the script and a metrics endpoint?

No. Use either or both. The script covers traffic and browser errors; a metrics endpoint adds your app's own numbers. Uptime checks work with neither.

Why isn't my data showing up?

The script doesn't run on localhost, 127.* or .local pages, so test on the real domain. Also check that the domain is in the site's hostname list, and that an ad blocker isn't blocking the script. The first-party proxy helps with ad blockers.

Can I track several domains as one site?

Yes. Add every hostname (for example with and without www) to the project's settings. Events from hostnames no project lists are dropped, and the Connections tab tells you about them.

Can I track a staging copy separately?

Yes. Add it as its own project with its staging hostname. Its events count there even when the staging build carries your production tag, as long as both projects are in the same workspace and no other project lists that hostname.

Can I monitor an API or a cron job?

Yes. Add an API's address and it gets uptime checks, on its health check when it has one. A cron job, backup or worker without an address is added as a scheduled job: it requests a secret ping URL after each run, and you're alerted when a run fails or doesn't arrive. See APIs and scheduled jobs.

How is the dashboard made?

Mosaicdeck generates it from what the site actually sends: traffic, your app metrics grouped as you grouped them, custom events and health. When AI is available it may arrange it more specifically. You can edit it any time, and your edits are never overwritten.

Data and privacy

What happens to email addresses in page URLs?

The script masks them in the visitor's browser, before anything is sent. Many sites serve their app for any URL, so a visitor who pastes an address into the address bar would otherwise send it as the page's path; instead /alice@example.com arrives as /:email. This is always on, and email addresses in error messages are masked too. IDs in paths, such as UUIDs, arrive as :id, you can hide short codes with the tag's data-mask attribute, and the query string is never sent.

Do I need a cookie banner?

The script sets no cookies and stores nothing in the browser, and IP addresses aren't stored. Whether you need any notice depends on the laws that apply to you, so check with your own adviser.

Are the numbers exact?

Page views and events are counted as received. Visitors are counted per day with a hash that changes daily, so the same person on two days counts twice, and ad blockers or disabled JavaScript hide some visits.

Who can see my data?

Members of your workspace, the AI apps you connect (read-only, and only the workspaces you pick), and anyone you share a report page link with.

AI and MCP

Which AI assistants work?

Claude (web, desktop, mobile and Claude Code) and any MCP client that supports remote servers over Streamable HTTP with OAuth sign-in.

Does the AI compute the numbers?

No. Mosaicdeck computes every number; the AI only reads and reports them. The server tells the AI to report numbers as given.

Is there a limit on AI questions?

Each workspace has an hourly limit on tool calls: 60 on Free, 600 on Pro and 2,000 on Agency. One question often uses a few calls.

Plans and billing

Is there a trial?

Your first workspace gets a 14-day Pro trial with no card required. After it ends, the workspace moves to Free unless you subscribe.

What happens when I reach my event limit?

You're emailed at 80% and 100%. Collection continues to 120%, then page views and custom events are dropped until the month ends or you upgrade. Errors, uptime and app metrics keep working. There are no surprise charges.

Can I invite my team?

On the Agency plan: 5 members are included, and you can add more seats. Members can be owners, admins or viewers.

Still stuck? See all docs or email support (address in the footer).