Skip to content

Add Adspirer to integrations#1559

Open
amekala wants to merge 3 commits intogoogle:mainfrom
amekala:add-adspirer-integration
Open

Add Adspirer to integrations#1559
amekala wants to merge 3 commits intogoogle:mainfrom
amekala:add-adspirer-integration

Conversation

@amekala
Copy link
Copy Markdown

@amekala amekala commented Apr 5, 2026

Summary

Adds documentation for the Adspirer MCP Server integration with ADK.

  • New integration page at docs/integrations/adspirer.md covering how it works, use cases, prerequisites, Python and TypeScript code examples, capabilities, supported platforms, and additional resources
  • Integration logo at docs/integrations/assets/adspirer.png

Adspirer is an AI-powered advertising MCP server with 100+ tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. It enables ADK agents to create, manage, and optimize ad campaigns through natural language — covering the full campaign lifecycle from keyword research to performance analysis.

Code examples

Both examples have been validated against the ADK source code:

  • Python (Local): Uses McpToolset + StdioConnectionParams with mcp-remote for OAuth 2.1 browser-based authentication
  • Python (Remote): Uses McpToolset + StreamableHTTPConnectionParams with Bearer token
  • TypeScript (Local): Uses MCPToolset + StdioConnectionParams with mcp-remote
  • TypeScript (Remote): Uses MCPToolset + transportOptions.requestInit.headers

Closes #1558

Adds Adspirer, an AI-powered advertising MCP server with 100+ tools
across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads.

Closes google#1558
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 5, 2026

Deploy Preview for adk-docs-preview ready!

Name Link
🔨 Latest commit 3bfe1b9
🔍 Latest deploy log https://app.netlify.com/projects/adk-docs-preview/deploys/69d424f046cd87000875b7da
😎 Deploy Preview https://deploy-preview-1559--adk-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@google-cla
Copy link
Copy Markdown

google-cla bot commented Apr 5, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Copy link
Copy Markdown
Collaborator

@koverholt koverholt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR! I left a few comments, one blocker for the model version string, and a couple of other tweaks to the content. Otherwise LGTM.

You will also need to sign the CLA before we are able to merge, you can see the details for that in the failing CI check related to the CLA.

<span class="lst-supported">Supported in ADK</span><span class="lst-python">Python</span><span class="lst-typescript">TypeScript</span>
</div>

The [Adspirer MCP Server](https://www.adspirer.com/) connects your ADK agent to
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest adding a link to https://github.com/amekala/ads-mcp here and in the Additional resources section.

Comment on lines +68 to +69
- An [Adspirer](https://www.adspirer.com/) account (free tier includes 15 tool
calls/month, no credit card required)
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- An [Adspirer](https://www.adspirer.com/) account (free tier includes 15 tool
calls/month, no credit card required)
- An [Adspirer](https://www.adspirer.com/) account (free tier available)

Suggest changing this to be more general in case these terms change and become stale or outdated.

from mcp import StdioServerParameters

root_agent = Agent(
model="gemini-3.0-pro",
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no gemini-3.0-pro model string. Suggest changing this to the latest current GA model throughout all code samples, which is gemini-2.5-pro and is consistent with all other integrations.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Adspirer advertising MCP server to integrations

3 participants