How to integrate Google AdSense MCP with Atomic Agent

Connect Atomic Agent to Google AdSense MCP. List google adsense sites needing review, show adsense earnings for last month, and more using natural language, with authentication handled for you.

Google AdSense logoGoogle AdSense
Oauth2

Google AdSense is a platform for managing website advertising, payments, and performance reports. It helps publishers monetize content and track ad revenue in one place.

33 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Google AdSense.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Google AdSense account. See the Atomic Agent documentation for installation instructions.

Also integrate Google AdSense with

How Atomic Agent connects to Google AdSense

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Google AdSense to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Google AdSense. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Google AdSense account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Google AdSense MCP server, and what's possible with it?

The Google AdSense MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google AdSense account. It provides structured and secure access to ad inventory, channels, sites, policy issues, payments, and performance reports, so your agent can manage ad units, review site and policy status, track payments, and analyze AdSense performance on your behalf.

  • Ad inventory management: Have your agent create, view, update, and retrieve code for display ad units in your AdSense account.
  • Channel organization: Let the agent create, inspect, update, and delete custom channels, or review URL channels and the ad units linked to them.
  • Performance reporting: Direct your agent to generate structured or CSV reports for selected AdSense performance data, or run saved reports.
  • Site and policy monitoring: Instruct your agent to list available sites, review policy issues and enforcement details, and retrieve account alerts.
  • Account and payment visibility: Have your agent review account details, list managed accounts, and retrieve paid and unpaid payment records.

Use Google AdSense from Atomic Agent

With your account connected, ask Atomic Agent to work with Google AdSense in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Google AdSense action and event your agent gets out of the box.

Create Ad Unit

Create a permanent DISPLAY ad unit under an AFC ad client.

Create Custom Channel

Create a custom channel under an ad client.

Delete Custom Channel

Permanently delete a Google AdSense custom channel.

Generate Report

Generate an ad hoc AdSense report as structured JSON rows.

Generate Report CSV

Generate an ad hoc AdSense report and return its CSV text verbatim.

Generate Saved Report

Run a publisher-created saved report and return structured JSON rows.

Generate Saved Report CSV

Run a publisher-created saved AdSense report and return CSV text.

Get Account

Return one AdSense account's state, setup tasks, timezone, and premium status.

Get Ad Blocking Recovery Tag

Return an account's ad blocking recovery tag and its optional error-protection code.

Get Ad Client

Return one ad client by its complete resource name.

Get Ad Client Code

Return standard and AMP AdSense code snippets for an AFC ad client.

Get Ad Unit

Return one Google AdSense ad unit by its complete resource name.

Get Ad Unit Code

Return the complete HTML code snippet for one Google AdSense ad unit.

Get Custom Channel

Return one custom channel by its complete resource name.

Get Policy Issue

Return one AdSense policy issue and all of its enforcement details.

Get Saved Report

Return one saved report's complete resource name and title.

Get Site

Return one AdSense site by its complete resource name.

Get URL Channel

Return one URL channel by its complete resource name.

List Accounts

Return one page of AdSense accounts available to the connected user.

List Ad Clients

Return one page of ad clients available in an AdSense account.

List Ad Unit Custom Channels

Return one page of custom channels linked to an AdSense ad unit.

List Ad Units

Return one page of ad units owned by an AdSense ad client.

List Alerts

Return AdSense account alerts localized to an optional language.

List Child Accounts

Return one page of accounts directly managed by a parent AdSense account.

List Custom Channel Ad Units

Return one page of ad units linked to a custom channel.

List Custom Channels

Return one page of custom channels owned by an AdSense ad client.

List Payments

Return paid and unpaid payment records available for an AdSense account.

List Policy Issues

Return one page of policy issues affecting an account or its AFP children.

List Saved Reports

Return one page of publisher-created saved reports for an account.

List Sites

Return one page of sites available in an AdSense account.

List URL Channels

Return one page of active URL channels owned by an AdSense ad client.

Update Ad Unit

Replace all writable settings of a DISPLAY ad unit.

Update Custom Channel

Replace all writable settings of a custom channel.

FAQ

Frequently asked questions

With a standalone Google AdSense MCP server, the agents and LLMs can only access a fixed set of Google AdSense tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google AdSense and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google AdSense tools.

Yes, absolutely. You can configure which Google AdSense scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google AdSense data and credentials are handled as safely as possible.

Start with Google AdSense.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google AdSense tool your agent needs.Free to start.

Start building