Cogniserve · Google Ads API Reporting Tool

An internal Model Context Protocol (MCP) server we use to query and analyze the Google Ads campaigns we manage on behalf of our clients.

Operated by Cogniserve · Hosted at cci-gads-mcp.cogniserve.tech · Office 210, 2nd Floor, Gera Imperium Star Building, Patto Business Center, Panaji, Goa 403001, India · cogniserve123@gmail.com · +91 95884 92385 · cogniserve.tech

1. What this tool is

This site hosts an internal reporting tool used by Cogniserve, a technology services firm based in Panaji, Goa, India (cogniserve.tech). As part of our client engagements we operate paid-media accounts — including Google Ads and Meta Ads — on behalf of clients who have authorized us as their manager. This tool exposes the Google Ads API through the Model Context Protocol (MCP), so authorized Cogniserve staff can query campaign performance using natural language through approved AI clients (such as Anthropic Claude) instead of manually exporting CSVs from the Google Ads dashboard.

The tool is not a public service. There is no signup, no client-facing UI, and no third-party access. Only Cogniserve staff with credentials reach the API endpoint at /mcp. Every request is HTTP-Basic-authenticated at the reverse proxy.

2. About Cogniserve

Cogniserve is a technology services firm based in Panaji, Goa, India. We design and build AI systems, industry-specific software platforms, and digital-transformation solutions for clients across multiple industries — with a particular focus on the maritime, charter, and yard-management sectors. Full service description at cogniserve.tech.

As part of a number of our client engagements, we also operate the client's digital marketing — including Google Ads and Meta Ads — under explicit manager-link authorization. Clients grant our manager (MCC) account permission to operate their advertising in line with the standard Google Ads agency workflow. The Google-Ads portion of our work spans:

Campaign setup, structure, and ongoing optimization
Keyword research and audience targeting
Performance reporting and analysis
Budget pacing and bid management
Creative and asset performance review

This tool replaces the manual reporting portion of that work. Instead of dashboard navigation and CSV exports, our staff ask questions in natural language and get answers backed directly by live Google Ads data.

Initial client

Cruising Club India www.cruisingclubindia.com · info@cruisingclubindia.com

Cruising Club India is the first client onboarded under this tool, and has authorized Cogniserve as its Google Ads manager via the standard manager-link mechanism. Additional clients across other industries (hospitality, B2B services, and others) will be added as they onboard.

3. Concrete use cases

Typical natural-language questions that our staff run through this tool:

"Which campaigns are pacing under budget this week and why?"
"Show conversions and cost per conversion for the top 10 keywords on this account this month, compared to last month."
"Which Performance Max asset groups have the highest CTR, broken down by creative type?"
"List the keywords that triggered impressions but zero clicks in the last 14 days."
"Compare campaign-level CPA across all our managed accounts for the current quarter."
"Which ad creatives are wearing out — high impressions, declining CTR over the last 30 days?"

Every query is read-only. The tool does not mutate campaigns, change bids, edit creatives, pause anything, or modify account settings. Reporting and analysis only.

4. Capabilities exposed to staff

Tool	What it returns
`list_accounts`	The Google Ads accounts our manager (MCC) has access to.
`get_account_currency`	Currency configured on a specific account.
`get_campaign_performance`	Impressions, clicks, conversions, cost, CPA, ROAS by campaign over a given date range.
`get_ad_performance`	Per-ad performance metrics including engagement and conversion data.
`get_ad_creatives`	Creative metadata: headlines, descriptions, asset structure for responsive search and display ads.
`get_image_assets`	Image asset metadata used in Performance Max, Display, and Shopping campaigns.
`get_asset_usage`	Which assets are used by which campaigns / ad groups, and how they are performing.
`analyze_image_assets`	Summarizes image-asset performance across campaigns.
`execute_gaql_query` / `run_gaql`	Run a custom Google Ads Query Language query for ad-hoc analysis.
`list_resources`	Lists valid GAQL resources for query construction.
`download_image_asset`	Retrieves an image asset for visual review by staff.

Campaign types covered: Search, Performance Max, Display, Shopping, and Video.

5. How it works

Authentication

The MCP endpoint is protected by HTTP Basic authentication at the reverse-proxy (Caddy) layer. The Google Ads API itself is accessed via a Google service-account JWT — the service account is added as a user on our manager (MCC) account, with consent of the account owner.

Data flow

AI client → MCP endpoint → Google Ads API → AI client. Data passes through the server in process memory only. Nothing is persisted, cached, sold, or shared with third parties.

Hosting

Self-hosted on a single small Linux VM operated by Cogniserve. The tool runs in a Docker container behind a Caddy reverse proxy. TLS via Let's Encrypt with automatic renewal.

Scope

Initially serves the Cogniserve Manager MCC (824-642-8525) and the client accounts linked under it. Designed to scale by adding additional containers as more clients are onboarded.

6. Google Ads API compliance

Use of the Google Ads API by this tool complies with:

Concretely:

The tool only queries accounts that have explicitly authorized our MCC as a manager.
No competitor data harvesting, no scraping, no sharing of advertiser data with third parties.
Service-account credentials are stored on the server with restricted file permissions (chmod 600) and never bundled with the application image or version control.
API usage is well within the Basic Access daily operations envelope — a typical day involves a few dozen reporting queries.
Queries are read-only. The tool does not perform mutate operations against the Google Ads API.

7. Technology stack

API: Google Ads API v20 (REST/HTTP)
Server: Python 3.11 with the mcp SDK (FastMCP), wrapping the open-source cohnen/mcp-google-ads server
Transport: Streamable HTTP (Model Context Protocol)
Auth: HTTP Basic at the proxy; Google service-account auth at the API layer
TLS: Caddy + Let's Encrypt
Containerization: Docker / Docker Compose

8. Privacy and terms

See Privacy Policy and Terms of Service for full statements on data handling, retention, and use.

9. Contact

Cogniserve
Office 210, 2nd Floor, Gera Imperium Star Building,
Next to Goa Central Library, Patto Business Center,
Panaji, Goa — 403001, India

Operational and compliance contact: cogniserve123@gmail.com · phone: +91 95884 92385 · web: cogniserve.tech