# Toolcape + Google Analytics

Toolcape connects a company’s existing AI to its systems through one MCP entry point, with account connections, group and individual permissions, and audit logs. This documentation describes a product prototype; it is not evidence that a live server or account is connected.

## The connection
Google Analytics: Reports about website traffic, events and conversions in Google Analytics.
API connection · AI uses Toolcape through MCP
Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.

## Typical actions
- Read: Retrieve traffic and conversion reports
This source reads reports. Use Analytics Admin separately if someone must change the setup.

## Setup
1. IT configures the provider app, API and requested scopes.
2. Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.
3. Make the service available in Toolcape. Set Everyone, group and individual rules for the actions actually needed. Adding a service does not grant access.
4. Connect the approved AI client to the actual Toolcape MCP address and sign in. Start with a harmless read-only task and check the audit log.

## Permissions
For personal delegated access, the provider account, approved app scopes and Toolcape rules must all permit the action. Shared accounts and application permissions may have other limits. Toolcape combines Everyone and group grants; a personal exception replaces inherited access for that service. Reading can disclose confidential information. Sharing, sending and deletion need separate consideration.

## Calling an operation
First discover which tools the connected Toolcape server actually exposes. If it offers search → describe → execute, find the relevant operation, inspect its input schema and permissions, then call it with validated inputs. Tool names vary by server; do not invent names, arguments, URLs or successful outcomes. Without connected tools, give setup guidance instead of claiming to perform actions.

## Operation reference
Catalog snapshot: 16 September 2026. Verify the current schema before calling.
- analyticsdataPropertiesBatchRunPivotReports — Batch Properties Run Pivot Reports
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:batchRunPivotReports
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesBatchRunReports — Batch Properties Run Reports
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:batchRunReports
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesRunRealtimeReport — Properties Run Realtime Report
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:runRealtimeReport
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesGetMetadata — Get Properties Metadata
  GET https://analyticsdata.googleapis.com/v1beta/{+name}
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesRunReport — Properties Run Report
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:runReport
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesRunPivotReport — Properties Run Pivot Report
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:runPivotReport
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesCheckCompatibility — Properties Check Compatibility
  POST https://analyticsdata.googleapis.com/v1beta/{+property}:checkCompatibility
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesAudienceExportsGet — Get Properties Audience Exports
  GET https://analyticsdata.googleapis.com/v1beta/{+name}
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesAudienceExportsQuery — Properties Audience Exports Query
  POST https://analyticsdata.googleapis.com/v1beta/{+name}:query
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesAudienceExportsList — List Properties Audience Exports
  GET https://analyticsdata.googleapis.com/v1beta/{+parent}/audienceExports
  https://developers.google.com/analytics/devguides/reporting/data/v1/
- analyticsdataPropertiesAudienceExportsCreate — Create Properties Audience Exports
  POST https://analyticsdata.googleapis.com/v1beta/{+parent}/audienceExports
  https://developers.google.com/analytics/devguides/reporting/data/v1/

## A useful first question
How did website traffic change last month?

## If it fails
Check the account, expired authorization, app approval, provider scopes and Toolcape permissions. Share only redacted errors with support. Never paste passwords, tokens or client secrets into an AI conversation.