GA4 MCP Server

Instructions

Implementation Reference

• src/tools/admin.ts:65-93 (handler)

  The main handler function listGoogleAdsLinks that implements the tool logic. It retrieves Google Ads links for a GA4 property by calling the Analytics Admin API, handles pagination, and returns a formatted response with the links array and total count.

  export async function listGoogleAdsLinks(propertyId: string): Promise<ToolResponse> {
    try {
      const client = await getAnalyticsAdminClient();
      const propertyName = constructPropertyResourceName(propertyId);
      const allLinks: unknown[] = [];
      let pageToken: string | undefined | null = undefined;
  
      do {
        const response: { data: GoogleAdsLinksResponse } = await client.properties.googleAdsLinks.list({
          parent: propertyName,
          pageToken: pageToken || undefined,
          pageSize: 200,
        });
  
        const data = response.data;
        if (data.googleAdsLinks) {
          allLinks.push(...data.googleAdsLinks);
        }
        pageToken = data.nextPageToken;
      } while (pageToken);
  
      return createSuccessResponse({
        googleAdsLinks: allLinks,
        totalCount: allLinks.length,
      });
    } catch (error) {
      return createErrorResponse(`Failed to list Google Ads links for ${propertyId}`, error);
    }
  }

• src/tools/index.ts:54-67 (registration)

  Tool registration and schema definition for ga4_google_ads_links. Defines the tool name, description, and input schema requiring a propertyId parameter.

  {
    name: "ga4_google_ads_links",
    description: "Returns a list of links to Google Ads accounts for a GA4 property. Shows which Google Ads accounts are connected to the property for data sharing.",
    inputSchema: {
      type: "object" as const,
      properties: {
        propertyId: {
          type: "string",
          description: "The Google Analytics property ID. Accepted formats: '123456789' or 'properties/123456789'",
        },
      },
      required: ["propertyId"],
    },
  },

• src/tools/index.ts:262-263 (registration)

  Tool routing that connects the ga4_google_ads_links tool name to its handler function listGoogleAdsLinks, extracting and casting the propertyId argument.

  case "ga4_google_ads_links":
    return await listGoogleAdsLinks(args.propertyId as string);