Advice and answers from the Advanced Web Ranking Team
>
>
Introducing Advanced Web Ranking MCP Server: Use AWR API data in your AI tools (ChatGPT & Claude)
Connect AI tools like ChatGPT & Claude to your AWR account via MCP Server to access real-time SEO data, rankings, and AI search insights .
Advanced Web Ranking MCP Server - Overview
The Advanced Web Ranking MCP Server enables AI agents to securely access the AWR API and enrich their responses with real-time data from your tracked campaigns. By connecting AI assistants directly to your AWR account, you can analyze rankings, identify trends, and generate actionable insights across SEO and AI Search visibility with greater speed and accuracy.
With the launch of AWR’s Remote MCP Server, MCP-enabled assistants such as ChatGPT and Claude can connect to your Advanced Web Ranking data through a secure, managed connection - no coding and no server setup required.
Why MCP Servers Matter
AI tools are great at reasoning and language, but they lack live, business-critical data. MCP servers bridge that gap by allowing AI assistants to securely retrieve:
Verified analytics data
Client performance metrics
SEO & marketing insights
Internal dashboards
External APIs like AWR
By connecting to these sources, the AI evolves from a general-purpose assistant into a specialized, data-aware expert, powered by real insights from Advanced Web Ranking. It’s like giving ChatGPT or Claude a direct line into your SEO command center.
Use Cases
With Advanced Web Ranking MCP, you can pull AWR data through your AI agents and speed up decision-making. For example:
Fetch live rankings
Reveal ranking drops and opportunities for certain keywords
Surface SERP features wins and competitive movements
Build reports or insights instantly
Answer SEO questions with real, current data, not guesses
MCP Server Access & Limits
Advanced Web Ranking hosts a remote MCP server that allows users with an Agency plan or higher to connect their AWR account to supported AI tools. Once connected, your setup is synced and available to use using the previously set connector selected.
Plan availability: The AWR MCP server is available on paid plans starting from Agency and higher.
Remote MCP connection URLs: https://api.advancedwebranking.com/mcp
Most popular AI tools support connecting to the remote MCP directly. If you run into issues, check out our step-by-step setup guides:
When you connect Advanced Web Ranking MCP to an AI agent:
You’ll see an authorization consent screen.
Once approved, the connection will appear in your Connectors & API settings - MCP section, with a dedicated API key (tagged with MCP scope).
You can also manually generate an MCP key in your account and use it in your AI agent’s configuration.
The MCP connection can be revoked at any time.
All data is pulled directly from your AWR account in real-time, ensuring you always have access to your latest SEO metrics and insights.
Connection Capabilities
The connector can access the data below and answer questions based on its current capabilities. We’re actively working on expanding this list and unlocking access to more data.
Project Management
Access project configuration, account settings, and tracking setup information.
What You Can Access | Action | Description | Example Questions to Ask |
|---|---|---|---|
Account Overview | getAccountDetails | View your account details, subscription plan, available resources, and active add-ons | What's my current AWR subscription plan? |
Project List | listProjects | See all SEO projects in your account with their basic information | Show me all my AWR projects, with selected update frequency |
Project Configuration | getProjectDetails | Get detailed setup for any project including main website, update schedule, keyword count, tracked search engines, and competitors | Tell me about the setup for my [project name] project |
Keyword Organization | getKeywords | View all keywords being tracked and their associated groups/keyword tags | List all keywords in my project |
Competitor List | getCompetitors | See which competitor websites you're benchmarking against | Who are my competitors in this project? |
Update History | getUpdates | View dates when rankings were collected (for historical analysis) | When were my rankings last updated? |
Project Performance Data & Analytics
Access ranking & AI search data, performance metrics, trends, and competitive insights for building reports and analysis.
What You Can Access | Action | Description | Example Questions to Ask |
|---|---|---|---|
Multi-Project Performance | getProjectsPerformance | Compare performance across all your projects with trends over time (last 2 updates, month, 3 months, or year) | How are all my projects performing during the latest quarter? Show me the ranking & visibility growth or decline rate |
Keyword Rankings | getRankings | View current and historical search positions for all tracked keywords, including ranking changes, traffic estimates, and SERP features | What are the most significant ranking performance changes compared to previous update? |
Visibility Metrics by Website | getVisibilityPerWebsites | Compare overall SEO visibility between your website and competitors, including visibility scores, market share, and traffic estimates | How does my visibility compare to competitors? Who is leading visibility trends? |
Visibility by Search Engine | getVisibilityPerSearchEngines | See how your visibility differs across Google, Bing, and other search engines | Am I performing better on Google or Bing? Compare my visibility across search engines |
Visibility by Keyword Group | getVisibilityPerKeywordGroups | Analyze performance by keyword categories (e.g., brand terms, product keywords, informational queries) | How are my brand keywords performing? |
Ranking Distribution | getDomainsDistribution | See how many keywords rank in different position ranges (1st place, top 3, top 10, etc.) across all domains | How many keywords rank in the top 10? |
Landing Page Performance | getLandingPagesPerformance | Identify which pages on your website rank for which keywords, with traffic estimates and performance metrics | What are my best-performing pages? |
Keyword Difficulty Analysis | getKeywordsDifficulty | Assess how hard it is to rank for specific keywords with difficulty scores, search intent, and content requirements | What are the easiest keywords to target? |
SERP Competitive Analysis | getSerpDifficulty getDifficultyUpdates | Deep dive into who ranks for a specific keyword with detailed competitor metrics (domain authority, backlinks, content scores) | Who are my main competitors for [keyword]? |
Cross-Engine Comparison | getSearchEnginesComparison | Compare how keywords rank differently across multiple search engines side-by-side | Compare rankings for [keyword] across all search engines |
AI Search Performance | getAiKeywordsPerformanc | Track your brand's presence in AI-generated answers from ChatGPT, Perplexity, Google AI Overviews & Google AI Mode. Includes AI visibility scores, citations, and brand mentions breakdown | How often am I cited in ChatGPT responses? Track my performance in AI overviews |
Set up the Advanced Web Ranking MCP server
MCP server endpoint
This server uses streamable HTTP transport only. The MCP endpoint is: https://api.advancedwebranking.com/mcp
Authentication
Advanced Web Ranking MCP supports two authentication mechanisms:
OAuth. OAuth is the default MCP server authentication approach. No additional configuration or headers are required.
When AWR MCP is connected, the AI agent automatically registers with the OAuth system and redirects you to the AWR account active in browser session or login page to authenticate and allow access.
API key. If your AI agent doesn't support OAuth, you can authenticate using an API key instead.
To generate a new MCP API key for your Advanced Web Ranking account, follow these steps:
Access the Connectors & API section
Click on MCP Server tab at the top of the page or scroll down to the section
Click “Create API key”
This works if you wish to activate the MCP connector manually, using OpenAI or Anthropic API.
Claude Desktop/Web
To enable connectors in Claude, you will need a Pro subscription or higher.
To add the Advanced Web Ranking MCP server to Claude (browser or desktop):
Navigate to Settings → Connectors → Add custom connector.
Name the connector and add the AWR MCP server URL: https://api.advancedwebranking.com/mcp
Normally, the OAuth 2.1 authentication process should automatically redirect you to the AWR account active in the browser session or login page to authenticate and allow access to your AWR account & projects data. In case the redirect doesn’t happen, use the custom configuration and grant permission.
For more information, refer to the official Anthropic documentation.
Claude Code
To add the Advanced Web Ranking endpoint to Claude Code settings, add a remote HTTP server by running the following command:
In the terminal, run this command:
claude mcp add advanced-web-ranking --transport http https://api.advancedwebranking.com/mcp
Launch Claude by writing “claude” in the terminal
Link your Advanced Web Ranking account to Claude Code by running this command:
/mcp connect advanced-web-ranking
Select Authenticate
The OAuth 2.1 authentication process should automatically redirect you to the AWR account active in browser session or login page to authenticate and allow access to your AWR account & projects data
For more details, refer to the official Claude MCP documentation.
ChatGPT
At the moment, it's only available in Developer mode for Pro and Plus accounts on the web.
We recommend keeping your prompts as explicit and precise as possible. For best results:
Mention the AWR MCP connector directly
Specify the exact tool or endpoint to use
Indicate which fields should be retrieved and how results should be sorted
Explicitly ask ChatGPT not to use web search
Clear, structured prompts generally produce more accurate and reliable results. For example:
Using the AWR MCP connector and the getRankings action, retrieve the top 10 performing keywords related to ‘seo’ in United States, sorted by search volume.
This is preferred over a vague prompt like:
What are the top keywords related to seo in United States?
For the latest updates and usage guidelines, refer to the official ChatGPT Developer Mode documentation.
Setup guide
Follow these steps to add the Advanced Web Ranking MCP server to ChatGPT Web:
Go to Settings → Apps and look for Advanced settings
Enable the "Developer mode"
Click the "Create app" button
Fill in the new Connector details:
Add your preferred connector name (such as Advanced Web Ranking MCP)
MCP server URL: https://api.advancedwebranking.com/mcp
Authentication: OAuth
Select the option “I trust this application” and click the "Create" button.
The OAuth 2.1 authentication process should automatically redirect you to the AWR account active in the browser session or login page to authenticate and allow access to your AWR account & projects data.
Check that the connector in ChatGPT is successfully connected
Activate the AWR connector in the chat before starting the query:
Click on the “+” sign → More → Developer mode
Select the connector you created earlier
Do you have any other questions? Don’t hesitate to get in touch and we will keep building the FAQ.
stay in the loop