TrueClicks MCP server
TrueClicks is a PPC audit and monitoring platform that automates Google Ads and Microsoft Ads account auditing. An AI agent connected to TrueClicks can retrieve audit scores, track monitoring issues, review check-level results, manage tasks, and monitor campaign performance targets—enabling PPC managers and marketing teams to stay on top of account health without manually reviewing the TrueClicks dashboard.
Setting up an MCP server
This article covers the standard steps for creating an MCP server in AI Gateway and connecting it to an AI client. The steps are the same for every integration — application-specific details (API credentials, OAuth endpoints, and scopes) are covered in the Authentication section on this page.
Before you begin
You'll need:
- Access to AI Gateway with permission to create MCP servers.
- API credentials for the application you're connecting (see the Authentication section on this page for what to collect).
Create an MCP server
Find the app in the catalog
- Sign in to AI Gateway and select App Catalog from the left navigation.
- Search for the application you want to connect, then select it from the catalog.
- Select Create MCP Server to start the wizard.
App Configuration
Confirm the Base URL for the API, then, under Tools, select the endpoints you want to expose. Select Next.
MCP Server Setup
- Enter a Name for your server — something descriptive that identifies both the application and its purpose.
- Enter a Description so your team knows what the server is for.
- Set the log level: choose Production Mode for terser logs, or Non-Production Mode for more verbose logs that can help with debugging.
- Select Next.
Authentication
Enter the authentication details for the application. This varies by service — see the Authentication section on this page for the specific credentials, OAuth URLs, and scopes to use.
Review
Look over the summary of your MCP server configuration, then select Create & Deploy. AI Gateway provisions the server and provides a server URL you'll use when configuring your AI client.
Connect to an AI client
Once your server is deployed, you'll need to add it to the AI client your team uses. Select your client for setup instructions:
Tips
- You can create multiple MCP servers for the same application — for example, a read-only server for reporting agents and a read-write server for automation workflows.
- If you're unsure which OAuth scopes to request, start with the minimum read-only set and add write scopes only when needed. Most application pages include scope recommendations.
Authentication
TrueClicks uses HTTP Basic authentication with Data Connector credentials. To generate credentials, log in to TrueClicks at https://app.trueclicks.com and navigate to the Reporting page. Scroll to the Data Connector section, enter a key of your choice, and select Create New Key. Use the generated Username as the Basic Auth username and the Token as the Basic Auth password. Each key pair grants read access to all accounts visible to the authenticated user.
Available tools
This MCP server provides access to account audit data, check-level results, user management, task tracking, and target monitoring across your Google Ads and Microsoft Ads accounts.
| Tool | Description |
|---|---|
| Get current account data | Retrieve the latest audit scores, monitoring issues, and auditing results for all accounts |
| Get historical account data | Access weekly audit score snapshots for up to 1 year of historical trend analysis |
| Get check-level results | View the calculated score and status for every audit and monitoring check across accounts |
| Get check output table | Retrieve detailed output table data for a specific check within a given account |
| Get users | List active users and pending invitations in the TrueClicks organization |
| Get tasks | Access task management data including titles, assignments, statuses, and due dates |
| Get active targets | View currently running target monitoring periods with metrics, thresholds, and performance |
| Get all targets | Access complete target monitoring history including current, past, and future periods |
Tips
Start with a quick account health check by pulling current account data to see overall scores, audit scores, and monitoring scores across all your Google Ads and Microsoft Ads accounts at a glance.
Investigate failing checks automatically — when account scores drop, have the agent retrieve check-level results to identify which checks are failing, then drill into the output table for the specific check to see affected campaigns, ad groups, and keywords.
Compare audit scores week over week using historical account data to spot regressions early — weekly snapshots go back up to a year, making it easy to correlate score changes with campaign updates.
Surface overdue tasks and workload summaries by pulling task data grouped by assignee and status — agents can flag high-priority items past their due date or summarize open work across the team.
Monitor campaign targets proactively — have the agent check active target monitoring periods and alert you when metrics like CPA or ROAS are trending off track before the period ends.
Cequence AI Gateway