Gosquared
GoSquared provides real-time web analytics and customer engagement tools to help businesses understand and interact with their website visitors.
Verdict
Common use cases
- Pull real-time visitor counts during launches
- Archive support chats after resolution
- Export trial signups for outreach campaigns
- Segment users by behavior for targeting
- Delete user profiles for GDPR requests
Integration
- Vendor
- Gosquared
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 43
- Composio slug
gosquared
Tools
- Account Shared Users
Tool to retrieve all team members that have access to a given project. Use after specifying the project to inspect user access.
- Add Account Site
Tool to add a new site to the GoSquared account. Use when you want to register a new site for data collection under your account.
- Add Shared User
Tool to add a new shared user to a project. Use when inviting team members via their email address.
- Archive Chat Conversation
Tool to archive a chat conversation. Use when you need to programmatically close out a chat after its session ends.
- Check API Token Validity and Scopes
Tool to check whether an API key is valid and retrieve its enabled scopes. Use when verifying API credentials before making further API calls.
- Create People SmartGroup
Tool to add a new Smart Group to a GoSquared project. Use when you need to segment users by custom criteria.
- Delete persondestructive
Tool to delete a person profile and all associated data. Use when you need to permanently remove a person's record and optionally blacklist them.
- Export Smart Group Feed
Tool to export all pageview activity for a Smart Group to CSV. Use when you need a temporary download link for up to 60 days of data; link expires after 15 minutes.
- Get Base Path Metrics
Tool to retrieve base path metrics over a time period. Use when you need to analyze the most common entry page paths for a site within a specified date range.
- Get Campaign Medium Metrics
Tool to retrieve UTM medium metrics over a time period. Use when analyzing campaign performance by medium.
- Get current concurrent visitors
Tool to retrieve the number of concurrent visitors currently on your site. Use when you need live, real-time visitor metrics.
- Get Page Metrics
Tool to retrieve page-level metrics over a specified period. Use when you want summarised page metrics for individual pages within a date range.
- Get People Event Types
Tool to retrieve event types ordered by tracked count. Use when you need to display the most tracked event types.
- Get People Property Types
Tool to retrieve all property types in People CRM. Use when you need to discover available profile or event properties.
- Get Person
Tool to retrieve a specific person profile by ID. Use when you need to fetch details of a person by their unique identifier.
- Get Real-Time Online Visitors
Tool to retrieve a list of current online visitors. Use when you need detailed real-time visitor information.
- Get Real-Time Overview
Tool to retrieve a summary of real-time data for the site. Use when a snapshot of current online visitor metrics and summary statistics is needed.
- Get Real-Time Popular Pages
Tool to retrieve the most popular pages currently being viewed on your site. Use when real-time active page data is needed.
- Get Real-Time Visitor Platforms
Tool to retrieve platforms used by online visitors sorted by visitor count. Use when you need a real-time breakdown of active visitor platforms.
- Get specific chat message
Tool to retrieve a specific chat message. Use when you have both chat ID and message ID to fetch the message details.
- Get Specific Visitor
Tool to retrieve information for a specific online visitor. Use after obtaining visitorID to get detailed visit data.
- Get Time Series
Tool to retrieve visitor counts over time as data points. Use when you need historical visitor data bucketed by interval.
- GoSquared - Get Person Feed
Tool to retrieve a specific person's event feed in reverse chronological order. Use after confirming the personID.
- GoSquared - People Devices
Tool to retrieve device information from People CRM. Use when you need a paginated view of a user's device usage.
- Leave Chat Note
Tool to leave a note in a chat conversation. Use when you need to annotate or add comments to an existing chat session.
- List Account Sites
Tool to list all projects/sites accessible to the authenticated account. Use when you need to retrieve the account's sites in either grouped or flat format.
- List People
Tool to search and filter People CRM profiles. Use when you need to retrieve a list of people based on query terms, specific property or event filters, sorting, and pagination.
- List People SmartGroups
Tool to retrieve all Smart Groups for a project. Use when you need to list the Smart Groups configured in your People project.
- Now Sources
Tool to retrieve the most influential traffic sources currently driving visitors to your site. Use when you need an up-to-the-minute breakdown of referrer sources.
- Remove shared userdestructive
Tool to remove a user from a GoSquared project. Use when you need to revoke a shared user's access to your site.
- Retrieve Aggregate Metrics
Tool to retrieve aggregate metrics for a specified period. Use after specifying both start and end date-times to obtain summarised metrics, optionally grouped by interval.
- Retrieve Chat Conversation
Tool to retrieve a chat conversation by its ID. Use when you need the full conversation history after obtaining a chat session ID.
- Retrieve Chat Conversations
Tool to retrieve chat data for reporting purposes. Use when you need to list active chat conversations within a specific time window.
- Retrieve Chat Feed
Tool to retrieve messages and events from a chat conversation. Use when you need to fetch chat history for a specific chat session.
- Retrieve Chat Messages
Tool to retrieve a list of messages from a chat conversation. Use after identifying the chatID via listing chat conversations to page through a chat's message history.
- Retrieve Event Counts
Tool to retrieve counts of event triggers over a specified time period. Use when you need to analyze event frequency for a site between two date-times.
- Send Chat Message
Tool to send a message in a chat conversation. Use after confirming chatID and providing auth if sending as client.
- Smart Group People
Tool to retrieve people in a specific Smart Group. Use when listing or filtering members of a Smart Group.
- Track GoSquared Event
Tool to send custom events to GoSquared. Use when tracking user or system events in analytics.
- Track GoSquared Identify
Tool to identify users and associate them with specific properties in GoSquared. Use after obtaining or confirming a visitor’s identity to link their anonymous activity with their known user record and update their profile.
- Track GoSquared Transaction
Tool to track e-commerce transactions. Use when a user completes a purchase and you need to record the transaction in GoSquared.
- Track Pageview
Tool to track pageviews. Use when you need to record a pageview event for a visitor after obtaining their visitor_id and page details.
- Unarchive Chat Conversation
Tool to unarchive a chat conversation. Use when you need to restore an archived chat back to active state after confirming that the conversation should be resumed.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP integrations page. 2. Click 'Add MCP' and select GoSquared from the developer tools category. 3. Log in to your GoSquared account, go to Settings > API Access, and generate a new API key. 4. Choose scopes based on what you need: 'Read Analytics' for traffic queries, 'Manage Chat' for conversation tools, 'Manage People' for user profiles. 5. Copy the API key and paste it into Switchy's connection form, then click 'Connect'. 6. Test the connection by opening any Space and typing '@gosquared check API token validity and scopes' — you should see your enabled permissions. 7. To invoke a tool, @mention GoSquared in a message followed by your request, like '@gosquared show me today's top landing pages' or '@gosquared archive conversation ID 12345'.
What teammates see: by default, memories from Gosquared are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Today's Traffic Summary
@gosquared Show me today's total visitors, the five most-viewed pages, and our top three traffic sources. Format it as a quick summary I can paste into our team channel.Open in a Space →
Export Trial Signups
@gosquared Create a Smart Group for people who signed up in the past 7 days, then export their pageview activity to CSV and give me the download link.Open in a Space →
Archive Resolved Chats
@gosquared Archive the chat conversation with ID 98765. Confirm when it's done so I know the ticket is fully closed.Open in a Space →
Check API Permissions
@gosquared Check my API token validity and list all enabled scopes. I want to confirm I have write access before making changes.Open in a Space →
Delete User Profile
@gosquared Delete the person profile for user ID abc123 and blacklist their email so they don't get tracked again. Confirm once it's done.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@gosquared show me all team members who have access to our production analytics project and their permission levels
Based on the project configuration, 7 team members currently have access: 3 admins (alice@company.com, bob@company.com, carol@company.com), 2 editors (dan@company.com, eve@company.com), and 2 viewers (frank@company.com, grace@company.com). All users were added within the last 90 days. This illustrative example reflects the typical structure returned by the Account Shared Users tool.
This example demonstrates read-only project inspection. Your API key must have the 'account:read' scope to retrieve team member lists. The MCP returns email addresses and role assignments but does not expose password hashes or other sensitive auth data.
@gosquared create a Smart Group called 'High-Value Mobile Users' for visitors who completed a purchase on iOS or Android in the last 30 days
Smart Group 'High-Value Mobile Users' created successfully with ID sg_abc123. The segment now tracks 1,847 people matching your criteria: mobile platform (iOS/Android) AND purchase event in the past 30 days. You can view this group in your GoSquared dashboard under People > Smart Groups. This illustrative response shows the confirmation structure returned after creating a new segment.
This example shows the Create People SmartGroup tool in action. Requires 'people:write' scope. Smart Groups update in real-time as visitor behavior changes, so the member count will fluctuate. The MCP does not validate your segmentation logic before creation—test criteria in the dashboard first.
@gosquared export the last 45 days of pageview activity for our 'Trial Users' Smart Group and summarize the top 5 most-visited pages
Export initiated for Smart Group 'Trial Users' (sg_xyz789). Temporary CSV download link generated, valid for 15 minutes: https://export.gosquared.com/temp/abc123.csv. Based on the export preview, the top 5 pages by trial user visits are: /pricing (4,203 views), /features/integrations (3,891), /docs/getting-started (3,102), /case-studies (2,456), /contact-sales (1,987). This illustrative summary combines the Export Smart Group Feed tool with AI analysis of the returned data.
This example pairs data export with AI synthesis. The export link expires after 15 minutes and supports up to 60 days of historical data. Requires 'people:read' scope. Large exports may take 30-60 seconds to generate—the MCP will wait for the link before returning it to you.
Use-case deep-dives
When GoSquared wins for customer support triage at 5-10 person scale
A 7-person SaaS support team uses GoSquared's chat and people tracking to route inbound questions. The MCP's archive and shared-user tools let an AI agent close conversations after resolution and add new support reps without touching the dashboard. This works when your team handles under 200 chats per day and you already use GoSquared as your primary live-chat tool. If you're routing across multiple channels (Intercom, email, Slack), the MCP becomes a narrow wedge—you'll spend more time context-switching than you save. The buying call: if GoSquared is your single source of truth for customer identity and chat history, the MCP turns Switchy into a triage copilot that archives, tags, and escalates without leaving the workspace.
When this MCP fits early-stage product teams running cohort tests
A 4-person product team at a B2B SaaS startup runs weekly feature experiments and needs to segment users by behavior (trial signups who viewed pricing twice, active users who haven't upgraded). GoSquared's SmartGroup tools let an AI agent create and export these segments on demand during planning sessions. This scenario works when your user base is under 10k profiles and you're not running complex multi-touch attribution—GoSquared's segmentation is fast but not warehouse-grade. If you need to join behavioral data with Stripe revenue or support ticket volume, you'll hit the MCP's scope limit and need a separate ETL step. The call: if your experiments live entirely in GoSquared's event stream and you're moving fast with small cohorts, the MCP saves you from manual CSV exports every sprint.
When GoSquared's site-add tool accelerates client onboarding at agencies
A 12-person digital agency onboards 3-5 new clients per month, each needing a GoSquared project for traffic and conversion tracking. The MCP's add-site and shared-user tools let an AI agent provision new projects and invite client stakeholders in one step during kickoff calls. This works when your agency standardizes on GoSquared for all clients and you're not mixing analytics platforms (if half your clients use GA4, the MCP becomes a one-off). The trade-off: GoSquared's 43 tools include deep chat and people features you won't use in a pure analytics play, so if you're only tracking pageviews, the MCP is overkill. The buying threshold: if you onboard more than two GoSquared clients per month and your team wastes 20 minutes per setup clicking through the dashboard, the MCP pays for itself in saved admin time.
Frequently asked
What does the GoSquared MCP let me do in Switchy?
It connects your GoSquared analytics and live chat data to Switchy's AI workspace. You can query visitor behavior, manage chat conversations, segment users with SmartGroups, and export pageview activity—all without leaving your workflow. The MCP exposes 43 tools covering account management, people profiles, chat operations, and data exports.
Do I need admin access to connect GoSquared MCP?
You need a GoSquared API key with the scopes you want to use. The MCP includes a tool to check your token's validity and enabled scopes before making calls. If your key lacks permissions for chat or people management, those tools will fail. Generate a new key in GoSquared's account settings if you need broader access.
Can the GoSquared MCP send live chat messages to visitors?
No. The MCP can archive chat conversations and retrieve chat data, but it doesn't include tools to send outbound messages or start new chats. If you need to respond to visitors, use GoSquared's web app or their dedicated chat API directly—this integration is read-heavy with some management actions.
Why use this MCP instead of GoSquared's dashboard?
The MCP lets you pull analytics and chat data into Switchy's shared context, where your team can cross-reference it with data from other tools—GitHub issues, Slack threads, CRM records. You skip tab-switching and can automate exports or SmartGroup creation. The dashboard is still better for real-time monitoring and visual exploration.
Who on my team should connect the GoSquared MCP?
Whoever owns your GoSquared account and can generate API keys. That's usually a product manager, growth lead, or engineering lead. Once connected in Switchy, any team member can invoke the tools in shared chats—they inherit the permissions of the connected API key, so audit what scopes you enable.