Gosquared MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Gosquared MCP or direct API to monitor live website traffic, fetch visitor analytics, trigger engagement messages, and segment users through natural language.
Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Gosquared Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Try Gosquared now

Enter a prompt below to test the integration in our Tool Router playground. You'll be redirected to sign in and try it live.

Supported Tools

Tools
Add Shared UserTool to add a new shared user to a project.
Remove shared userRemoves a shared user from a GoSquared project by their email address, revoking their access to the site.
Account Shared UsersRetrieves all team members who have access to the current GoSquared project.
List Account SitesList all projects/sites accessible to the authenticated account.
Check API Token Validity and ScopesTool to check whether an API key is valid and retrieve its enabled scopes.
Block VisitorTool to block a specific visitor from being tracked.
Retrieve Chat ConversationRetrieve detailed information about a chat conversation by its ID.
Retrieve Chat MessagesRetrieve messages from a GoSquared chat conversation by chat ID.
Retrieve Chat ConversationsTool to retrieve chat data for reporting purposes.
Retrieve Chat FeedRetrieve the complete feed of messages and events from a chat conversation.
Create Account WebhookTool to create a webhook to receive notifications about events in a GoSquared project.
Create Webhook TriggerTool to add a trigger to an existing GoSquared webhook.
Delete Account WebhookTool to delete a webhook from a GoSquared account.
Delete personTool to delete a person profile and all associated data.
Timeout Visitor SessionsTool to end all tracking sessions for a specified visitor in GoSquared.
Get Account Blocked ItemsTool to retrieve a list of blocked IP addresses, bots, and visitors for a project.
Get Account Blocked BotsTool to retrieve the bot blocking status for a GoSquared project.
Get Blocked IP AddressesTool to retrieve the list of blocked IP addresses for the account.
Get Account Blocked VisitorsTool to retrieve visitor IDs that have been blocked for a project.
Get Account Site DetailsTool to retrieve detailed information about a specific site/project by its site_token.
Get Account Sites UsageTool to retrieve all sites and their pageview counts for the authenticated account.
Get Account Tagged VisitorsTool to retrieve the list of tagged visitors from the account.
Get Account Trigger TypeTool to retrieve details of a specific trigger type from GoSquared.
Get Account Trigger TypesTool to retrieve available types of triggers in GoSquared.
Get Account WebhookTool to retrieve a specific webhook by ID from a GoSquared account.
Get Account WebhooksRetrieves a list of webhooks configured for the GoSquared project.
Get Account Webhook TriggersRetrieves all triggers for a webhook.
Get Specific Chat MessageRetrieve a specific chat message by its message ID from a chat conversation.
Get Real-Time Visitor BrowsersTool to retrieve browsers used by currently online visitors, sorted by visitor count.
Get Real-Time CampaignsTool to retrieve currently running campaigns with real-time visitor counts.
Get Real-Time Visitor CountriesTool to retrieve countries where currently online visitors are located, sorted by visitor count.
Get Real-Time EngagementTool to retrieve engagement information of currently online users.
Get Real-Time Visitor Geo LocationsTool to retrieve real-time geographic coordinates for currently online visitors.
Get Real-Time Visitor LanguagesTool to retrieve languages for currently online visitors sorted by visitor count.
Get Now NotificationsTool to retrieve notifications stored in GoSquared.
Get Real-Time OrganisationsTool to retrieve internet organisations currently being used by online visitors, sorted by visitor count.
Get Now Sources By SectionTool to retrieve a specific group of real-time traffic sources such as 'site', 'organic', or 'social'.
Get Current TimeTool to retrieve the current time according to GoSquared infrastructure.
Get Specific VisitorRetrieves real-time session information for a specific online visitor.
Get People Event TypesRetrieve all event types tracked in GoSquared People CRM, ordered by frequency.
Get People Property TypesRetrieve property types (schema definitions) from GoSquared People CRM.
Get Person ProfileRetrieve a specific person's profile from GoSquared People CRM by their unique ID.
GoSquared - Get Person FeedRetrieve a person's complete event feed from GoSquared People CRM.
Get Browser MetricsTool to retrieve summarised browser metrics over a specified time period.
Get Campaign Content MetricsRetrieve UTM content metrics (utm_content) aggregated over a specified date range.
Get Campaign Name MetricsRetrieve UTM campaign name metrics (utm_campaign) aggregated over a specified date range.
Get Campaign Source MetricsRetrieve UTM source metrics (utm_source) aggregated over a specified date range.
Get Campaign Term MetricsRetrieve UTM term metrics (utm_term) aggregated over a specified date range.
Get Category MetricsTool to retrieve summarised category metrics over a specified time period.
Get Country MetricsRetrieve country-level visit metrics aggregated over a specified date range.
Get Language MetricsRetrieve summarised language metrics over a given time period.
Get Organisation MetricsTool to retrieve summarised organisation metrics over a given time period.
Get Operating System MetricsTool to retrieve summarised operating system metrics over a specified time period.
Get Product MetricsTool to retrieve summarised product metrics over a specified time period.
Get Screen Dimensions MetricsTool to retrieve summarised screen dimensions metrics over a specified time period.
Get Traffic Sources MetricsTool to retrieve a historical list of traffic sources that referred visitors to the site over a specified period.
Get Trends Sources By TypeTool to retrieve a historical list of sources for the given section type.
Get Transaction MetricsTool to retrieve summarised transaction metrics over a specified time period.
List PeopleSearch and filter tracked people in GoSquared People CRM.
Get current concurrent visitorsTool to retrieve the number of concurrent visitors currently on your site.
Get Real-Time Popular PagesRetrieve the most popular pages currently being viewed on your site in real-time.
Get Real-Time Visitor PlatformsTool to retrieve platforms used by online visitors sorted by visitor count.
Get Real-Time OverviewTool to retrieve a summary of real-time data for the site.
Now SourcesTool to retrieve the most influential traffic sources currently driving visitors to your site.
Get Visitor Time SeriesRetrieves time series data showing the number of concurrent visitors to your site over time.
Get Real-Time Online VisitorsTool to retrieve a list of current online visitors.
GoSquared - List All DevicesRetrieve a paginated list of all devices tracked in GoSquared People CRM.
Export Smart Group FeedExport all pageview activity for users in a Smart Group to a downloadable CSV file.
Smart Group PeopleRetrieve people (user profiles) from a specific Smart Group in GoSquared People CRM.
List People Smart GroupsRetrieve all Smart Groups for a GoSquared People CRM project.
Add Account SiteCreates a new site/project in the GoSquared account for analytics tracking.
Archive Chat ConversationArchives a chat conversation in GoSquared Inbox.
Send Chat MessageSend a message to a visitor in a GoSquared chat conversation.
Leave Chat NoteAdds an internal note to a GoSquared chat conversation.
Unarchive Chat ConversationUnarchives a chat conversation in GoSquared Inbox.
Create People SmartGroupCreate a new Smart Group in GoSquared People CRM to segment users by custom criteria.
Send Tracking PingSends a ping to keep the visitor session active in GoSquared.
Tag VisitorTool to add a tag to an identified visitor in GoSquared.
Track GoSquared EventTrack custom events in GoSquared analytics.
Identify UserIdentify a user in GoSquared and set their profile properties.
Track PageviewTracks a pageview event in GoSquared Analytics.
Track GoSquared TransactionTrack e-commerce transactions in GoSquared analytics.
Track User PropertiesTrack user properties for a visitor in GoSquared.
Retrieve Aggregate MetricsRetrieve aggregate web analytics metrics for a specified time period.
Get Campaign Medium MetricsRetrieve UTM medium metrics (utm_medium) aggregated over a specified date range.
Retrieve Event CountsRetrieve counts of tracked event triggers over a specified time period.
Get Page MetricsRetrieve page-level visit metrics over a specified time period.
Get Base Path MetricsRetrieves base path metrics (first URL path segments) over a time period.
Update Account Blocked BotsTool to update the automatic bot blocking feature for a project.
Update Account Blocked IPsTool to update the list of IP addresses to be blocked for a GoSquared project.
Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Gosquared tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all projects accessible to my account in Gosquared')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Why Use Composio?

AI Native Gosquared Integration

  • Supports both Gosquared MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Gosquared data

Managed Auth

  • Built-in API key management with zero manual handling
  • Central place to manage, scope, and revoke Gosquared access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Gosquared
  • Scoped, least privilege access to Gosquared resources
  • Full audit trail of agent actions to support review and compliance

Use Gosquared with any AI Agent Framework

Choose a Framework you want to connect Gosquared with

Frequently Asked Questions

Do I need my own developer credentials to use Gosquared with Composio?

Yes, Gosquared requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗