GrowthSpree MCP Product Knowledge

1. What is Growthspree MCP?

Growthspree MCP is an AI-powered marketing platform. You connect your advertising and analytics accounts once, then use natural language to:

• Analyze campaign performance
• Pull reports across Google, Meta, LinkedIn, Microsoft, HubSpot, and more
• Run scheduled audits delivered by email or Slack
• Chat with an AI agent in the browser or inside Claude (Desktop / Code) via MCP

How it works (simple view):

• mcp.zipline.com — Where you sign in, connect accounts, chat, and manage scheduled reports.
• Backend (secure) — Stores your OAuth connections and issues your personal API key.
• AI server — Runs the agent and marketing tools using your connections (never share your login password with the AI; it uses secure tokens behind the scenes).

You do not need to be a developer to use the web app. Developers and power users can additionally connect Claude Desktop or Claude Code using the same API key.

2. Getting started — your account

Sign up (email and password)

1. Go tohttps://mcp.zipline.com and create an account with your work email.
2. Check your inbox for an activation email from Growthspree MCP.
3. Click the activation link (it opens the site to complete activation).
4. Sign in with your email and password.

If you do not see the email, check spam/promotions and search for ops@growthspree.in.

Sign up or sign in with Google

1. Choose Sign in with Google on the login or signup page.
2. Complete Google authorization.
3. You are signed in and your account is activated automatically (no separate activation email).

Sign in

• Use email + password, or Google, on the login page.
• After login, the app provides your API key (see below). Keep it private.

Forgot password

1. Use Forgot password on the login page.
2. Open the link in the email from Growthspree MCP.
3. Set a new password and sign in again.

Your profile

In account settings you can view:

• Name and email
• Whether your account is active
• Optional: your own Claude API key (bring-your-own-key), if your organization uses that feature

Your API key

Every active user has a Zipline API key (32-character key). It:

• Authenticates the web chat and MCP clients (Claude) to your connected data
• Must be treated like a password — do not post it in Slack, tickets, or screenshots

You typically see it when you log in. If you lose it, contact your administrator or Growthspree support to reset access.

Log out

Use Log out in the app. This invalidates your session; you will need to sign in again (and may need your API key again for MCP clients).

3. Connecting integrations

Open the Integrations page: https://mcp.zipline.com/integrations

There you see which platforms are Connected or Not connected. Connecting an account lets the AI read data you authorize (campaigns, analytics, CRM, etc.).

General steps (most platforms)

1. Click Connect for the integration you want.
2. Sign in at the provider (Google, Meta, Microsoft, etc.) and approve access.
3. You are returned to the Integrations page.
4. If asked, choose the account, property, or site you want to use (e.g. one Google Ads customer ID or one GA4 property).
5. Status shows Connected with the account name.

To disconnect: use Disconnect / Detach for that integration on the same page.

Google Ads

• Supports a single account or an MCC (manager) account.
• For MCC: you may need to pick a child account in chat so reports target the right customer.
• Use this for: campaign lists, performance, GAQL-style queries, account structure.

Google Analytics (GA4)

• Connect your Google account, then select the GA4 property.
• Use this for: traffic, events, property reports.

Google Search Console

• Connect Google, then select the site (domain or URL-prefix property).
• Use this for: search queries, pages, indexing, sitemaps.

Meta (Facebook) Ads

• Connect with Meta/Facebook login and select the ad account.
• Requires Premium (or higher) access on your API key unless your admin granted Meta explicitly.
• Use this for: ad account insights, campaigns, creatives.

Microsoft Advertising

• Sign in with Microsoft and connect your ads account.
• Use this for: campaigns, reporting, account management tools.

LinkedIn Ads

• Connect LinkedIn and select your ad account.
• Included on Basic plans by default.

HubSpot CRM

• Connect HubSpot; the portal is linked automatically after OAuth (no separate account picker).
• Use this for: contacts, companies, CRM search, conversations.

Shopify

• Enter your store domain (e.g. your-store.myshopify.com), then complete Shopify OAuth.
• Note: Shopify often requires an explicit grant on your account even if you have Premium — ask your admin if Connect fails or tools are missing.
• Use this for: orders, customers, products (when enabled for your account).

Slack

• Connect your workspace for:
• Scheduled report delivery to a channel
• The Growthspree bot replying in channels/DMs
• After OAuth, pick channels when setting up reports or test messages.

Manager (MCC) vs single account

For Google Ads and Google Analytics you may choose:

• Single — One account/property only.
• MCC — Manager account; you may need to set which child account is active in a chat thread.

If the AI says it cannot resolve an account, open the chat’s integration context and select the correct child account.

4. AI chat on the web

Available athttps://mcp.zipline.com when your account includes chat access (Premium, Admin, or custom grant).

Start and manage conversations

• New chat — Starts a fresh thread.
• History — Open past conversations; rename or pin important ones.
• Delete — Remove threads you no longer need.

Company context

Set Company context once (business description, goals, brand voice). The AI uses this in every conversation so answers fit your business.

Custom prompts

Save reusable prompts (e.g. “Weekly Google Ads performance summary”) and run them without retyping.

Per-chat account context

In a conversation you can tie the thread to a specific connected account, for example:

• Google Ads customer
• GA4 property
• Search Console site
• Meta ad account
• LinkedIn / Microsoft / Shopify account

Use this when you manage multiple brands or MCC children so the AI queries the right account.

Sharing a conversation

Scheduled reports and some emails include a link like:

https://mcp.zipline.com/chat/c/{conversation-id}

Anyone with the link may view that conversation snapshot (treat links as sensitive).

5. Scheduled reports (automated audits)

Automated audits run on a schedule and deliver results by email or Slack.

What you can schedule

• Google Ads account audit — Automated review of your Google Ads account.
• Facebook (Meta) Ads account audit — Automated Meta ads review.
• Custom report name and instructions — You can name a report and add extra instructions the AI should follow.

Configure a scheduled report

1. Open Scheduled reports (or Reports) in the app.
2. Create a new schedule.
3. Set:
4. Frequency — Daily, weekly, or monthly
5. Time — Hour, minute, AM/PM
6. Days — Weekdays (daily/weekly) or day of month (monthly)
7. Delivery — Email or Slack
8. Recipients — Email addresses (comma-separated) or Slack channel
9. Subject / message — Optional email subject and body text
10. Custom instructions — Extra guidance for the audit (optional)
11. Turn the schedule Active.
12. Use Send test email or Send test Slack to verify delivery before relying on it.

Requirements

• The related integration must stay connected (e.g. Google Ads for a Google audit).
• Slack delivery requires Slack connected and a valid channel name.
• Long audits may take several minutes; check execution logs if a run fails.

Execution logs

Each schedule has a log history (recent runs, success/failure). Use this when a report did not arrive.

6. Slack

Connect Slack

1. Integrations → Slack → Connect.
2. Approve the app in your workspace.
3. Confirm status shows connected with your workspace name.

Use cases

Disconnect Slack

Detach Slack from Integrations. Scheduled Slack reports will fail until you reconnect.

7. Your plan and what you can access

Access is controlled by your account role on the API key. Your admin assigns this when provisioning your account.

Shopify is special: even Premium/Admin users may need an admin to explicitly enable Shopify on the key.

If a feature says “integration not allowed,” contact your organization admin or Growthspree support.

8. Power users — Claude Desktop & Claude Code (MCP)

Use the same API key as the web app to connect external AI clients to your marketing tools.

Server details

Claude Code (recommended for developers)

Example (Claude CLI):

claude mcp add "growthspree-zipline" --transport http https://mcp-server.zipline.com/claude_code_mcp/ --header "x-api-key: YOUR_API_KEY"

Replace YOUR_API_KEY with the key from your Growthspree account.

Claude Desktop

Add an MCP server in Claude Desktop settings using:

• URL: https://mcp-server.zipline.com/claude_desktop_mcp/
• Header: x-api-key = your API key

(Exact UI labels may vary by Claude Desktop version; use HTTP/SSE transport as offered.)

What you get in MCP

• Tools match connected integrations and your role.
• If Google Ads is not connected, Google Ads tools will not return useful data.
• The agent instructions brand the server as Growthspree MCP Tools.

Best practices

• Never commit API keys to git or share in public channels.
• Rotate by requesting a new key from admin if exposed.
• Connect integrations on the web first, then use MCP.

9. What you can ask the AI to do

High-level capabilities (exact tool names are internal; ask in plain language):

Tips:

• Be specific about date range, account, and metric.
• For MCC accounts, specify which child account or set thread context first.
• For recurring needs, use scheduled reports instead of repeating the same chat.

10. Troubleshooting

11. Security and privacy

• Passwords are stored securely by the platform; the AI never sees your Google/Meta password.
• OAuth tokens are stored server-side and refreshed as needed for API calls.
• API key grants access to your connected data — treat as confidential.
• Emails for activation and password reset come from Growthspree MCP (ops@growthspree.in).
• Share links to chats (/chat/c/...) — only send to people who should see that conversation.
• Report suspected compromise of API key or account to your admin immediately.

12. Frequently asked questions (FAQs)

Account and login

Q: Do I need a work email? A: Use an email you check regularly; activation and reports are sent there.

Q: I signed up but cannot log in. A: You must click the activation link in the signup email first. Google sign-in skips this step.

Q: Can I use both password and Google on the same email? A: Use the method you registered with; contact support if you need to merge accounts.

Q: Where do I find my API key? A: It is shown when you log in to mcp.zipline.com. Store it in a password manager. There is no public “rotate” button in the app — contact admin if you need a new key.

Q: Can I use my own Claude (Anthropic) API key? A: Some accounts support bring-your-own-key in account settings. Ask your admin if you do not see the option.

Integrations

Q: Why do I have to connect accounts? A: The AI reads live marketing data through secure OAuth. Without a connection, it cannot query your campaigns or analytics.

Q: Is it safe to connect Google Ads / Meta? A: You approve only the permissions shown on the provider screen. You can disconnect anytime from Integrations.

Q: Can I connect multiple Google Ads accounts? A: You connect one primary customer or MCC flow per integration record; use MCC + child selection or multiple users/keys for multiple brands (ask admin).

Q: What is MCC vs single account? A: Single = one Ads account. MCC = manager account with many children; pick the active child in chat context for accurate answers.

Q: HubSpot connected but no account picker? A: HubSpot links the whole portal on OAuth — no extra picker is required.

Q: Shopify connect fails. A: Enter the exact Shopify domain (name.myshopify.com). Shopify may require admin to enable it on your API key even on Premium.

Q: How do I disconnect an integration? A: Integrations page → Disconnect / Detach for that platform.

AI chat

Q: Why is Chat missing from my menu? A: Web chat requires chat permission (Premium, Admin, or custom grant on your API key).

Q: What is Company context? A: A global text block (your business, goals, tone) applied to all chats so answers stay relevant.

Q: What are Custom prompts? A: Saved instructions you reuse (e.g. weekly report wording).

Q: Why did the AI use the wrong ad account? A: Set per-thread account context for that integration, especially with MCC or multiple brands.

Q: Can I share a chat with a colleague? A: Yes via share links in emails or reports (/chat/c/...). Treat as confidential.

Scheduled reports

Q: What audits are available out of the box? A: Google Ads account audit and Facebook Ads account audit are built-in types; you can also use custom report names and instructions.

Q: Email vs Slack delivery? A: Choose one per schedule. Slack needs Slack connected and a valid channel name (e.g. #marketing).

Q: Report did not run at the scheduled time. A: Open execution logs for that schedule. Verify it is Active, integration connected, and time zone expectations match your team.

Q: How do I test without waiting for the schedule? A: Use Send test email or Send test Slack on the schedule.

Q: Can I send to multiple emails? A: Yes — enter comma-separated addresses in recipients.

Slack

Q: What permissions does the Slack app need? A: Typical scopes include reading channels and posting messages so the bot can reply and deliver reports.

Q: Bot does not reply in a channel. A: Invite/add the app to the channel per your workspace rules; reconnect Slack if token expired.

Q: Can I use Slack without web chat? A: Yes, if your role includes Slack integration; scheduled reports and the bot work independently of web chat.

MCP / Claude Desktop / Claude Code

Q: What is MCP? A: Model Context Protocol — a standard way for Claude (and other clients) to call tools (your marketing APIs) securely.

Q: Do I need MCP if I only use the website? A: No. MCP is optional for power users who want Claude Desktop or Claude Code.

Q: Which URL do I use for Claude Code? A: https://mcp-server.zipline.com/claude_code_mcp/ with header x-api-key: YOUR_KEY.

Q: Which URL for Claude Desktop? A: https://mcp-server.zipline.com/claude_desktop_mcp/ with the same API key header.

Q: Tools in Claude are grayed out or empty. A: Connect integrations on the web first; confirm your role allows that integration; check the API key header spelling (x-api-key).

Q: Is the API key the same as my login password? A: No. Password logs you into the website; API key authenticates chat and MCP to your data.

Access, billing, and admin

Q: How do I get Facebook Ads or chat on a Basic account? A: Ask your organization admin to upgrade you to Premium or add integrations to a Custom key.

Q: Who do I contact for access changes? A: Your internal admin who provisioned Growthspree MCP, or ops@growthspree.in.

Q: Can I have multiple users on one company? A: Yes — each user has their own login and API key; integrations are per user unless your admin sets up shared patterns.

Data and compliance

Q: Where is data processed? A: Data is fetched from official APIs (Google, Meta, etc.) through your connections; storage and processing follow your agreement with Growthspree / your admin.

Q: Does Growthspree train on my ads data? A: Refer to your contract and privacy policy; this knowledge base describes product behavior, not legal terms.

Q: How do I delete my account? A: Contact ops@growthspree.in or your admin; disconnect integrations first if required by your policy.