Troubleshooting
Every MarStack error says what went wrong. Here is what to do about each one.
MarStack does not appear in my client
- Restart fully. Claude Desktop must be quit from the tray or menu bar, not just closed, before it reads a new config.
- Check the JSON. A missing comma or bracket stops the whole config from loading. Paste it into a JSON checker if in doubt.
- Claude Desktop needs Node.js 20 or later to start the marstack-mcp package. Run
node --versionto check. - See what the package says. Run
npx -y marstack-mcp --versionin a terminal. For full detail, add"MARSTACK_DEBUG": "1"to the env block and read the Claude Desktop MCP log (Settings, Developer). - In Claude Code, run
/mcp. In Cursor, open Settings, MCP. Both show whether marstack connected and why not.
The assistant answers without using MarStack
Name it in the question: "Use MarStack to check the tracking on example.com". Once a client has seen MarStack work, it usually picks it on its own.
Error messages
- Couldn’t register with MarStack’s sign-in service (Claude) or the connector will not connect.
- Check the address is exactly https://mcp.getinlytics.com/mcp, then try Connect again. If the MarStack page says the sign-in expired, start again from your AI app: sign-ins wait 10 minutes.
- This connection was revoked. Connect MarStack again in your AI app.
- Someone clicked Disconnect on the Tokens page. Remove MarStack from the app and add it again, then sign in.
- No MarStack token was sent.
- The client config has no Authorization header or token. Paste the config from the Tokens page again, then restart the client.
- This is not a MarStack token. Tokens start with msk_live_ or msk_test_.
- Part of the token is missing or extra text was copied. Copy it again, or create a new token if you no longer have it.
- This token is not recognised.
- The token was deleted or mistyped. Create a new one on the Tokens page.
- This token was revoked on (date).
- Someone revoked it on the Tokens page. Create a new token and update the client config.
- GA4 is not connected.
- Connect Google on the Platforms page. Website checks work without it; GA4, GTM and Search Console tools need it.
- The Google connection for (account) needs to be renewed.
- Google stopped accepting the connection, often after a password change or removed access. Click Reconnect on the Platforms page.
- None of your connected Google accounts can open GTM-XXXX.
- Ask the container owner to add one of your Google accounts in GTM Admin, User Management, or connect the account that has access. For a site you do not manage, ask for a public GTM audit instead.
- MarStack Intelligence and the agent are part of the paid plans.
- The Free plan includes every MarStack tool through your AI client. Choose Starter, Pro or Agency on the Billing page to ask in the portal and run agent tasks.
- Not enough credits: (tool) needs (n) and you have (m).
- Top up or move to a bigger plan in the dashboard. Free tools such as listing and reports still work.
- Could not load (url). No credits were charged.
- The site was down, blocked the browser or the address is wrong. Check the URL opens in your own browser and try again.
Still stuck?
Email hello@getinlytics.com with the exact message and the name of your AI client.