# Gosquared — how to use (mcp.ai)

Connect your Gosquared account and use 90 tools for analytics straight from your AI agent. Connect with your own API key. GoSquared provides real-time web analytics and customer engagement tools to help businesses understand and interact with their website visitors.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_gosquared?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `gosquared_account_add_shared_user`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/gosquared`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/gosquared/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/gosquared/account/add/shared/user` — Tool to add a new shared user to a project. Use when inviting team members via their email address.
  - body: { role?: string, email: string, notify?: boolean }
- `POST https://api.mcp.ai/api/gosquared/account/remove/shared/user` — Removes a shared user from a GoSquared project by their email address, revoking their access to the site. Requires owner-level API key permissions. Use GOSQUARED_ACCOUNT_SHARED_USERS first to list cur
  - body: { email: string }
- `POST https://api.mcp.ai/api/gosquared/account/shared/users` — Retrieves all team members who have access to the current GoSquared project. Returns each user's ID, email, access state (owner/active/pending), and role (owner/admin/member). Requires an API key with
- `POST https://api.mcp.ai/api/gosquared/account/sites` — List all projects/sites accessible to the authenticated account. Requires 'read_account' API key scope. Use 'grouped' format to see owned vs shared sites, or 'flat' for a simple list.
  - body: { presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/auth/token/info` — Tool to check whether an API key is valid and retrieve its enabled scopes. Use when verifying API credentials before making further API calls.
  - body: { api_key: string }
- `POST https://api.mcp.ai/api/gosquared/block/visitor` — Tool to block a specific visitor from being tracked. Use when you need to prevent tracking for a particular visitor ID.
  - body: { visitor_id: string }
- `POST https://api.mcp.ai/api/gosquared/chat/chat` — Retrieve detailed information about a chat conversation by its ID. Use this tool when you need to: - Get the current state of a chat conversation (agent assignment, read status) - View the latest mess
  - body: { chatID: string }
- `POST https://api.mcp.ai/api/gosquared/chat/chat/messages` — Retrieve messages from a GoSquared chat conversation by chat ID. Use this tool to: - Fetch message history from a specific chat conversation - Page through chat messages with offset and limit - Filter
  - body: { limit?: string, chatID: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/gosquared/chat/chats` — Tool to retrieve chat data for reporting purposes. Use when you need to list active chat conversations within a specific time window.
  - body: { limit?: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/gosquared/chat/feed` — Retrieve the complete feed of messages and events from a chat conversation. Use this action to: - Fetch chat history and conversation timeline for a specific person - Review messages exchanged between
  - body: { limit?: string, chat_id: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/gosquared/create/account/webhook` — Tool to create a webhook to receive notifications about events in a GoSquared project. Use when you need to register a new webhook endpoint for real-time event notifications.
  - body: { url: string, name?: string, value?: string, trigger?: string, include_unverified?: boolean }
- `POST https://api.mcp.ai/api/gosquared/create/webhook/trigger` — Tool to add a trigger to an existing GoSquared webhook. Use when configuring webhook alerts for traffic spikes, traffic dips, chat messages, or smart group events.
  - body: { value: string, trigger: string, webhookID: integer }
- `POST https://api.mcp.ai/api/gosquared/delete/account/webhook` — Tool to delete a webhook from a GoSquared account. Use when you need to remove an existing webhook by its ID.
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/gosquared/delete/person` — 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.
  - body: { blacklist?: boolean, person_id: string }
- `POST https://api.mcp.ai/api/gosquared/end/visitor/sessions` — Tool to end all tracking sessions for a specified visitor in GoSquared. Use when you need to manually terminate a visitor's session, such as when a user logs out or closes their browser. Optionally sp
  - body: { page?: object, visitor_id: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/blocked` — Tool to retrieve a list of blocked IP addresses, bots, and visitors for a project. Use when you need to see all blocked items across all categories.
  - body: { presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/blocked/bots` — Tool to retrieve the bot blocking status for a GoSquared project. Use when you need to check whether automatic bot blocking is enabled.
- `POST https://api.mcp.ai/api/gosquared/get/account/blocked/ips` — Tool to retrieve the list of blocked IP addresses for the account. Use when you need to view which IP addresses are currently blocked from tracking or accessing the site.
- `POST https://api.mcp.ai/api/gosquared/get/account/blocked/visitors` — Tool to retrieve visitor IDs that have been blocked for a project. Use when you need to list visitors who were blocked (typically via the 'Ignore' button in the visitor widget).
  - body: { presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/site` — Tool to retrieve detailed information about a specific site/project by its site_token. Use when you need to fetch configuration details, ownership info, or metadata for a particular GoSquared project.
  - body: { site_token: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/sites/usage` — Tool to retrieve all sites and their pageview counts for the authenticated account. Use when you need to get usage statistics across all sites. Optionally filter by date range using 'from' and 'to' pa
  - body: { to?: string, from?: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/tagged/visitors` — Tool to retrieve the list of tagged visitors from the account. Use when you need to see which visitors have been tagged and their associated tags.
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/trigger/type` — Tool to retrieve details of a specific trigger type from GoSquared. Use when you need to understand the payload structure and fields for a particular trigger type before setting up automation workflow
  - body: { trigger_type: string }
- `POST https://api.mcp.ai/api/gosquared/get/account/trigger/types` — Tool to retrieve available types of triggers in GoSquared. Use when you need to discover what trigger types are supported for automation workflows or webhook configurations.
- `POST https://api.mcp.ai/api/gosquared/get/account/webhook` — Tool to retrieve a specific webhook by ID from a GoSquared account. Use when you need to fetch details about an existing webhook configuration.
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/gosquared/get/account/webhook/triggers` — Retrieves all triggers for a webhook. Use when you need to view which events are configured to fire a specific webhook.
  - body: { webhook_id: integer }
- `POST https://api.mcp.ai/api/gosquared/get/account/webhooks` — Retrieves a list of webhooks configured for the GoSquared project. Returns webhook details including ID, URL, event type, and active status. Use this to audit configured webhooks or verify webhook int
- `POST https://api.mcp.ai/api/gosquared/get/chat/chat/message` — Retrieve a specific chat message by its message ID from a chat conversation. Use this tool when you need to fetch details of a particular message, such as its content, sender, and timestamp. Requires 
  - body: { chat_id: string, message_id: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/browsers` — Tool to retrieve browsers used by currently online visitors, sorted by visitor count. Use when you need real-time breakdown of which browsers active visitors are using.
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/campaigns` — Tool to retrieve currently running campaigns with real-time visitor counts. Use when you need to see which campaigns are actively driving visitors to the site right now.
  - body: { limit?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/countries` — Tool to retrieve countries where currently online visitors are located, sorted by visitor count. Use when you need real-time geographic distribution of active site visitors.
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/engagement` — Tool to retrieve engagement information of currently online users. Use when you need real-time metrics about visitor behavior including time on site and visit depth.
- `POST https://api.mcp.ai/api/gosquared/get/now/geo` — Tool to retrieve real-time geographic coordinates for currently online visitors. Returns latitude/longitude coordinates with visitor counts for each location. Use when you need to visualize or analyze
  - body: { limit?: string, dateFormat?: string, visitorsMode?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/languages` — Tool to retrieve languages for currently online visitors sorted by visitor count. Use when you need a real-time breakdown of active visitor languages.
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/notifications` — Tool to retrieve notifications stored in GoSquared. Use when you need to access Traffic Alerts, RSS feed items, or Milestones.
  - body: { limit?: string, to_date?: string, from_date?: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/organisations` — Tool to retrieve internet organisations currently being used by online visitors, sorted by visitor count. Use when you need real-time data about which ISPs or network providers your visitors are using
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/sources/by/section` — Tool to retrieve a specific group of real-time traffic sources such as 'site', 'organic', or 'social'. Use when you need up-to-the-minute data about a particular source category driving visitors to yo
  - body: { limit?: string, minimal?: boolean, sections: string, drillLimit?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/time` — Tool to retrieve the current time according to GoSquared infrastructure. Use when you need a synchronized timestamp from GoSquared's servers.
  - body: { dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/now/visitor` — Retrieves real-time session information for a specific online visitor. Use this tool after obtaining a visitorID from GOSQUARED_NOW_VISITORS to get detailed information about a visitor including their
  - body: { limit?: string, presenter?: string, visitorID: string, visitorsMode?: string }
- `POST https://api.mcp.ai/api/gosquared/get/people/event/types` — Retrieve all event types tracked in GoSquared People CRM, ordered by frequency. Use this to discover available events for filtering or building Smart Groups.
- `POST https://api.mcp.ai/api/gosquared/get/people/property/types` — Retrieve property types (schema definitions) from GoSquared People CRM. Use this tool to: - Discover all available profile properties and their data types - Get custom property definitions - Look up a
  - body: { custom_only?: boolean, property_id?: string }
- `POST https://api.mcp.ai/api/gosquared/get/person` — Retrieve a specific person's profile from GoSquared People CRM by their unique ID. Use this tool when you need to: - Fetch detailed profile information for a known person - Look up custom properties s
  - body: { person_id: string }
- `POST https://api.mcp.ai/api/gosquared/get/person/feed` — Retrieve a person's complete event feed from GoSquared People CRM. Returns a chronologically ordered list of all events (custom events and session events) for a specific person. Use this tool to: - Vi
  - body: { sort?: string, type?: string, limit?: string, query?: string, to_time?: string, personID: string, from_time?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/browser` — Tool to retrieve summarised browser metrics over a specified time period. Use when analyzing which browsers were used to access the site during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/campaign/content` — Retrieve UTM content metrics (utm_content) aggregated over a specified date range. Use this to analyze which content variations (e.g., banner ads, sidebar links, footer CTAs) are driving traffic to yo
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/campaign/name` — Retrieve UTM campaign name metrics (utm_campaign) aggregated over a specified date range. Use this to analyze which marketing campaigns (e.g., 'spring_sale', 'newsletter_2024') are driving traffic to 
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/campaign/source` — Retrieve UTM source metrics (utm_source) aggregated over a specified date range. Use this to analyze which traffic sources (e.g., google, facebook, newsletter) are driving visitors to your site.
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/campaign/term` — Retrieve UTM term metrics (utm_term) aggregated over a specified date range. Use this to analyze which specific keywords or terms are driving traffic to your site.
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/category` — Tool to retrieve summarised category metrics over a specified time period. Use when analyzing which content categories were accessed during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, interval?: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/country` — Retrieve country-level visit metrics aggregated over a specified date range. Use this to analyze which countries are driving traffic to your site during a specific period.
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/language` — Retrieve summarised language metrics over a given time period. Use this to analyze which languages your visitors are using based on browser settings. Returns a ranked list of languages by visitor coun
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/organisation` — Tool to retrieve summarised organisation metrics over a given time period. Use when analyzing which internet organisations (ISPs, network providers, companies) are driving traffic to your site during 
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/os` — Tool to retrieve summarised operating system metrics over a specified time period. Use when analyzing which operating systems were used to access the site during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/product` — Tool to retrieve summarised product metrics over a specified time period. Use when analyzing ecommerce product performance, revenue, and transaction data during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/screen/dimensions` — Tool to retrieve summarised screen dimensions metrics over a specified time period. Use when analyzing which screen dimensions (resolutions) were used to access the site during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/sources` — Tool to retrieve a historical list of traffic sources that referred visitors to the site over a specified period. Sources are grouped by category: direct, organic (search engines), site (referrals), s
  - body: { group?: boolean, limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string, sourceType?: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/sources/by/type` — Tool to retrieve a historical list of sources for the given section type. Use when analyzing which sources (referring websites, social media, search engines, or internal) drove traffic during a specif
  - body: { group?: boolean, limit?: string, format?: string, to_date: string, from_date: string, date_format?: string, source_type: string }
- `POST https://api.mcp.ai/api/gosquared/get/trends/transaction` — Tool to retrieve summarised transaction metrics over a specified time period. Use when analyzing transaction data including revenue and quantity during a specific date range.
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/list/people` — Search and filter tracked people in GoSquared People CRM. Use this tool to: - List all tracked people or search by text query - Filter people by properties (email, name, etc.) or tracked events - Sort
  - body: { sort?: string, limit?: string, query?: string, fields?: string, filters?: object[], presenter?: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/now/concurrents` — Tool to retrieve the number of concurrent visitors currently on your site. Use when you need live, real-time visitor metrics.
- `POST https://api.mcp.ai/api/gosquared/now/pages` — Retrieve the most popular pages currently being viewed on your site in real-time. Returns pages ordered by visitor count. Use this tool when you need to know which pages are currently active and how m
  - body: { href?: string, limit?: string }
- `POST https://api.mcp.ai/api/gosquared/now/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.
  - body: { limit?: string, presenter?: string }
- `POST https://api.mcp.ai/api/gosquared/now/v3/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.
  - body: { to_date?: string, from_date?: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/now/v3/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.
  - body: { limit?: string, minimal?: boolean, sections?: string, drillLimit?: string }
- `POST https://api.mcp.ai/api/gosquared/now/v3/time/series` — Retrieves time series data showing the number of concurrent visitors to your site over time. Use this tool when you need to analyze visitor traffic patterns, identify peak hours, or track historical v
  - body: { to_time?: string, interval?: string, from_time?: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/now/visitors` — Tool to retrieve a list of current online visitors. Use when you need detailed real-time visitor information.
  - body: { limit?: string, to_date?: string, from_date?: string, dateFormat?: string, visitorsMode?: string }
- `POST https://api.mcp.ai/api/gosquared/people/devices` — Retrieve a paginated list of all devices tracked in GoSquared People CRM. This tool returns information about every device that has ever been tracked, including platform (OS), browser, screen size, IS
  - body: { limit?: string }
- `POST https://api.mcp.ai/api/gosquared/people/smart/groups` — Retrieve all Smart Groups for a GoSquared People CRM project. Smart Groups are saved user segments based on property or event filters. Use this action to list all configured Smart Groups and their fil
- `POST https://api.mcp.ai/api/gosquared/people/smartgroup/feed` — Export all pageview activity for users in a Smart Group to a downloadable CSV file. Returns a time-limited URL (valid for 15 minutes) to download the CSV. Supports filtering by date range (max 60 days
  - body: { to_date?: string, group_id: string, from_date?: string }
- `POST https://api.mcp.ai/api/gosquared/people/smartgroup/people` — Retrieve people (user profiles) from a specific Smart Group in GoSquared People CRM. Smart Groups are saved user segments defined by property or event filters. Use this action to list users matching a
  - body: { sort?: string, limit?: string, query?: string, fields?: string, group_id: string, presenter?: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/post/account/sites` — Creates a new site/project in the GoSquared account for analytics tracking. Returns the site_token needed to configure tracking on the new site. Requires: API key with 'write_account' scope (not suppo
  - body: { url: string, name?: string, timezone?: string }
- `POST https://api.mcp.ai/api/gosquared/post/chat/chat/archive` — Archives a chat conversation in GoSquared Inbox. Use this action to close out completed chat sessions, move resolved conversations out of the active inbox, or organize chat history. Archived chats can
  - body: { chatID: string }
- `POST https://api.mcp.ai/api/gosquared/post/chat/chat/message` — Send a message to a visitor in a GoSquared chat conversation. Use this tool to: - Send messages as an agent to website visitors - Send automated bot responses - Send messages on behalf of a client (re
  - body: { auth?: string, chatID: string, sender?: string, content: string, timestamp?: integer }
- `POST https://api.mcp.ai/api/gosquared/post/chat/chat/note` — Adds an internal note to a GoSquared chat conversation. Notes are visible only to agents in the Inbox and are useful for leaving context, follow-up reminders, or team coordination messages. The chatID
  - body: { chatID: string, sender?: string, content: string, timestamp?: integer }
- `POST https://api.mcp.ai/api/gosquared/post/chat/chat/unarchive` — Unarchives a chat conversation in GoSquared Inbox. Use this action to restore an archived chat back to active state, making it visible in the active inbox again. This is useful when you need to resume
  - body: { chatID: string }
- `POST https://api.mcp.ai/api/gosquared/post/people/smartgroups` — Create a new Smart Group in GoSquared People CRM to segment users by custom criteria. Smart Groups are dynamic user segments based on property filters (like email, name, status) or event-based filters
  - body: { name: string, prefs?: object, filters: object[], sortDir?: string, sortField?: string }
- `POST https://api.mcp.ai/api/gosquared/send/tracking/ping` — Sends a ping to keep the visitor session active in GoSquared. Must be received at least once every 30 seconds to maintain the session, otherwise the session will time out. Use this when implementing c
  - body: { page: object, visitor_id: string }
- `POST https://api.mcp.ai/api/gosquared/tag/visitor` — Tool to add a tag to an identified visitor in GoSquared. Use when you need to categorize, segment, or label visitors for organizational purposes or marketing campaigns.
  - body: { tag: string, visitorID: string }
- `POST https://api.mcp.ai/api/gosquared/track/properties` — Track user properties for a visitor in GoSquared. Use to set or update profile information for identified users or anonymous visitors. Properties include email, name, company details, and custom field
  - body: { name?: string, email?: string, phone?: string, avatar?: string, custom?: object, status?: string, company?: object, username?: string, last_name?: string, person_id?: string, created_at?: string, first_name?: string, visitor_id?: string, description?: string }
- `POST https://api.mcp.ai/api/gosquared/tracking/event` — Track custom events in GoSquared analytics. Use to record user actions like signups, purchases, button clicks, or any custom event. Events are associated with visitors/people and appear in their activ
  - body: { ip?: string, page?: object, event: object, total?: object, screen?: object, campaign?: object, language?: string, location?: object, referrer?: string, person_id?: string, returning?: boolean, user_agent?: string, visitor_id?: string, character_set?: string, last_pageview?: string }
- `POST https://api.mcp.ai/api/gosquared/tracking/identify` — Identify a user in GoSquared and set their profile properties. Links anonymous visitor activity to a known user identity and creates/updates their profile in the People dashboard. Requires 'write_trac
  - body: { person_id: string, properties?: object, visitor_id?: string }
- `POST https://api.mcp.ai/api/gosquared/tracking/pageview` — Tracks a pageview event in GoSquared Analytics. Use this to record when a visitor views a page on your site. Requires visitor_id (unique identifier for the visitor) and page URL. Optionally include ad
  - body: { ip?: string, page: object, total?: object, screen?: object, campaign?: object, language?: string, location?: object, referrer?: string, returning?: boolean, timestamp?: string, user_agent?: string, visitor_id: string, character_set?: string, last_pageview?: string }
- `POST https://api.mcp.ai/api/gosquared/tracking/transaction` — Track e-commerce transactions in GoSquared analytics. Use this when a customer completes a purchase to record the transaction details including items purchased, revenue, and customer identification. T
  - body: { ip?: string, page?: object, total?: object, screen?: object, campaign?: object, language?: string, location?: object, person_id?: string, returning?: boolean, timestamp?: string, user_agent?: string, visitor_id?: string, transaction: object, character_set?: string, last_pageview?: string }
- `POST https://api.mcp.ai/api/gosquared/trends/aggregate` — Retrieve aggregate web analytics metrics for a specified time period. Returns key metrics like pageviews, unique visitors, visits, bounce rate, engaged time, and e-commerce data, grouped by hour, day,
  - body: { limit?: string, format?: string, to_date: string, interval?: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/trends/campaign/medium` — Retrieve UTM medium metrics (utm_medium) aggregated over a specified date range. Use this to analyze which marketing mediums (e.g., email, social, cpc, organic) are driving traffic to your site.
  - body: { limit?: string, to_date: string, from_date: string, date_format?: string, response_format?: string }
- `POST https://api.mcp.ai/api/gosquared/trends/event` — Retrieve counts of tracked event triggers over a specified time period. Use this tool to analyze how frequently custom events have been triggered on your site. Events must first be tracked using the G
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/trends/page` — Retrieve page-level visit metrics over a specified time period. Returns a ranked list of pages by visit count within the date range. Use this to analyze which pages received the most traffic during a 
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/trends/path1` — Retrieves base path metrics (first URL path segments) over a time period. Use this to analyze which top-level URL paths (e.g., '/blog', '/products', '/wiki') receive the most traffic. Useful for under
  - body: { limit?: string, format?: string, to_date: string, from_date: string, dateFormat?: string }
- `POST https://api.mcp.ai/api/gosquared/update/account/blocked/bots` — Tool to update the automatic bot blocking feature for a project. Use when you need to enable or disable bot filtering for analytics tracking.
  - body: { block: boolean }
- `POST https://api.mcp.ai/api/gosquared/update/account/blocked/ips` — Tool to update the list of IP addresses to be blocked for a GoSquared project. Use when you need to block specific IP addresses from being tracked in analytics.
  - body: { ip: string }

## Example prompts
- "What can I do in Gosquared?"
- "Show me a summary of my Gosquared account"

## More
- Page: https://mcp.ai/gosquared
- Agent spec (llms.txt): https://mcp.ai/gosquared/llms.txt
- Postman collection: https://mcp.ai/gosquared/postman.json