TopRank
Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
What is TopRank?
TopRank is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to google ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Google Ads analysis and operations — read performance, manag
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx toprankConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use TopRank
TopRank (also known as NotFair) is an MCP server that connects AI agents to Google Ads and Meta Ads accounts, exposing roughly 100 Google Ads tools and a focused set of Meta Ads capabilities. It handles OAuth 2.1 authentication automatically using your OS keychain, so no API keys need to be stored in config files. Marketers and growth teams use it to analyze ad performance, discover keywords, adjust bids and budgets, manage negative keyword lists, and run parallel GAQL queries — all through natural language in their MCP client.
Prerequisites
- Node.js 18+ installed (required to run npx)
- An active Google Ads account (OAuth login via browser at notfair.co)
- Optionally a Meta Ads account for Meta capabilities
- An MCP client such as Claude Desktop or Claude Code
Install via npx
Run the server using npx. The first launch will guide you through OAuth authentication with Google Ads (and optionally Meta Ads) via a browser tab.
npx toprankAuthenticate with Google Ads
On first run, a browser tab opens to notfair.co where you sign in with your Google account. OAuth tokens are stored in your OS keychain automatically. No manual key configuration is needed.
Review generated config files
After authentication, the server creates ~/.notfair.json storing your accountId (Google Ads) and metaAccountId (Meta Ads). Legacy state including portfolio history and change logs is kept in ~/.toprank/.
Add server to your MCP client config
Add the toprank server entry to your Claude Desktop or Claude Code configuration file so it starts alongside your client.
{
"mcpServers": {
"toprank": {
"command": "npx",
"args": ["toprank"]
}
}
}Verify connection
Open your MCP client and ask a simple performance question. The server should respond with data from your connected Google Ads account.
TopRank Examples
Client configuration
Claude Desktop configuration for the TopRank MCP server using npx.
{
"mcpServers": {
"toprank": {
"command": "npx",
"args": ["toprank"]
}
}
}Prompts to try
Example prompts that leverage TopRank's Google Ads and SEO capabilities.
- "Review last week's changes across all my Google Ads campaigns"
- "Which search terms are wasting budget with no conversions this month?"
- "Pause all keywords with a CPA over $50 in campaign X"
- "Add negative keywords for irrelevant queries in my brand campaign"
- "Adjust bids on the top 10 highest-impression keywords by +15%"Troubleshooting TopRank
Browser tab does not open during OAuth authentication
Ensure you are running the command in an environment with a desktop browser available. On headless servers, use a local machine for the initial auth step; tokens will be cached in the OS keychain for future headless use.
Server reports 'accountId not found' after authentication
Check ~/.notfair.json to confirm the accountId field is populated. If empty, re-run the auth flow by deleting ~/.notfair.json and restarting the server.
npx command not found or version mismatch
Ensure Node.js 18+ is installed and npx is available on PATH. Run 'node --version' to verify. Update Node.js via nvm or your package manager if needed.
Frequently Asked Questions about TopRank
What is TopRank?
TopRank is a Model Context Protocol (MCP) server that google ads analysis and operations — read performance, manage keywords, bids, and campaigns. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install TopRank?
Follow the installation instructions on the TopRank GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with TopRank?
TopRank works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is TopRank free to use?
Yes, TopRank is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
TopRank Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to TopRank? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
MCP GSC
★ 875Google Search Console Insights with Claude AI for SEOs
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up TopRank in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use TopRank?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.