Skip to main content
Vantage

MCP setup

Connect Vantage to your AI

A remote MCP server, so there's nothing to install. Four steps, one of which is "paste a URL".

01

Start your plan

Vantage MCP needs an active subscription (Starter is £29/mo with a 7-day free trial). This is what connects your Google Search Console data to the tools.

02

Connect Google Search Console

In your dashboard, connect GSC with read-only access. Without it the tools have no search data to analyse — vantage_connect will tell you if this step is missing.

03

Add the server to your AI client

Use the one-line config for your client below. On first use the client opens your browser to authorize — sign in to Vantage and click Allow.

04

Call vantage_connect

Ask your assistant to run vantage_connect. It verifies the connection and returns your site profile. From there, vantage_quick_wins is the fastest place to start.

Per-client configuration

Settings → Connectors → Add custom connector. Paste this URL and click connect — Claude handles the login.

https://mcp.vantagerank.co.uk

Health check

Confirm the server is reachable from your network:

curl https://vantagerank.co.uk/api/health

Troubleshooting

Wrong transport type

Vantage is a Streamable HTTP server, not stdio and not SSE. Make sure your config uses the HTTP/streamableHttp transport (the snippets below are correct). The single most common mistake is pasting the URL into a "command" field meant for local stdio servers.

Expired or revoked token

Access tokens last 90 days, and disconnecting from your dashboard revokes them immediately. If calls suddenly return authentication_required, remove and re-add the server — your client will re-authorize in one click.

No GSC connection

If tools return gsc_not_connected, your Google Search Console is not linked yet. Connect it at your dashboard → Connections (read-only, one click), then retry.

Ad-blocker on the OAuth popup

Some ad-blockers and strict privacy extensions block the authorization popup or its redirect back. If the browser window does not return you to your client, allow popups for vantagerank.co.uk and try again.

Firewall or proxy

Corporate firewalls sometimes block the streaming response. Confirm your network allows HTTPS to mcp.vantagerank.co.uk. A quick test: open the health endpoint below in a browser — it should return ok.