MCP Server

Quick Start

Personalized Installation Guide

Download the guide — your API key is already included. Drag the file into Claude and ask him to set up the MCP.

No Claude account yet? Download Claude en Claude Code (npm install -g @anthropic-ai/claude-code)

When logged in, the file contains your personal API key. Don't share the file.

1

Remote (no install)

Add the server URL directly to Claude Code or Cursor. No local installation required. 8 free tools work instantly without an API key.

2

Get API key (optional)

Go to Account > API Keys and create a new key. The key starts with lc_. This unlocks all premium and Google tools.

3

Use tools

Ask Claude Code directly for SEO data: traffic, keywords, backlinks, competitors and more - all from the chat.

The quickest way to get started is the remote server: no installation, no dependencies. Just start with the command from the "Setup: Remote Server" section.

Available Tools

The MCP Server provides 32 tools. 8 free tools work without an API key. 19 premium tools require a valid API key with credits. 5 Google/Project tools require an API key but don't consume credits.

Free Tools (8)

Tool	Description	Credits
classify_keywords_simple	Keyword classification via local regex (offline, no API): Intent, Brand type, Funnel stage, Topic, Conversion Score. For DataForSEO-based analysis: classify_keywords_advanced (paid).	Free
seo_checklist	SEO checklists for 5 types: general, blog, ecommerce, discover, backlink	Free
seo_guidance	SEO best practices on 10 topics such as technical SEO, content, backlinks, Core Web Vitals and more	Free
get_google_guidelines	Official Google guidelines by category: Helpful Content, EEAT, Spam, Core Updates, Structured Data, and more	Free
analyze_url_structure	URL SEO analysis: length, readability, keywords in the URL, special characters, recommendations	Free
get_account_info	Check credit balance and subscription tier: available credits, subscription tier, account information	Free
list_locations	Available countries and regions for location-specific data queries for traffic and keywords	Free
get_skill	SEO Workflow Skills: Ready-made guides for SEO audits, keyword research, competitor analysis, and more. List available skills with name="list".	Free

Premium-Tools (19)

Premium tools require a valid API key with sufficient credits. The number of credits deducted depends on the data volume of the query. Check your balance anytime with get_account_info.

Google-First Fallback: Tools get_traffic_snapshot, get_historical_traffic and get_keywords automatically detect whether Google Analytics or Search Console is connected. If yes, real Google data is used (0 Credits). If not, DataForSEO is used as fallback (costs Credits). The response contains a data_source-field with the value 'google' en 'dataforseo'.

Tool	Description	Credits
classify_keywords_advanced	Keyword classification using DataForSEO Search Intent API + regex classifier: intent, brand type, funnel stage, topic, modifiers and conversion score per keyword	Dynamic
get_traffic_snapshot	Current traffic of a domain. Automatically uses Google Analytics (free) if connected, otherwise DataForSEO (credits). Response includes data_source.	Dynamic
get_historical_traffic	Historical traffic trends. Automatically uses Google Analytics (free) if connected, otherwise DataForSEO (credits, up to 5 years). Response includes data_source.	Dynamic
get_keywords	Top Keywords for a Domain. Automatically uses Google Search Console (free, real click data) if connected, otherwise DataForSEO (credits). Response includes data_source.	Dynamic
get_competitors	Competitor domains by keyword overlap: shared keywords, traffic comparison, similarity score	Dynamic
get_backlinks	Backlink profile for a domain: Domain Rating (0-100), total backlinks, referring domains, DoFollow/NoFollow breakdown	Dynamic
get_referring_domains	Referring domains with authority score, number of backlinks per domain and DoFollow share	Dynamic
validate_keywords	Validate search volume, competition (CPC) and keyword difficulty for a list of keywords	Dynamic
crawl_website	Website crawl with subsequent 24-point on-page analysis: title, meta tags, structure, internal links, load time	15-60
onpage_analysis	24-point on-page SEO audit of a single URL: title, meta description, H1-H6, alt tags, canonical URL, robots directives	15
check_serp	Live Google SERP results for a keyword: Top-10 organic results with position, URL, domain, title — for competitor analysis and content gap detection	15
check_links	Broken link detection for a domain or URL: HTTP status codes, dead links, redirect chains	20
check_pagespeed	Google PageSpeed Insights + Core Web Vitals: Performance, Accessibility, and SEO scores, LCP, CLS, TBT, FCP, and top optimization recommendations	5
audit_sitemap	XML Sitemap Audit: total URLs, duplicates, broken links (sample up to 200 URLs), lastmod coverage, sitemap structure	20
check_structured_data	JSON-LD and Microdata validation: Detect schema types, check required fields, identify errors and warnings for Article, Product, Organization, FAQPage, etc.	5
check_hreflang	Hreflang validation: x-default present, language codes valid, all target URLs reachable, bidirectional linking checked	10
seo_agent	SEO Agent System: 6 specialized agents for crawling, SEO analysis, strategy, copywriting, content review and consulting	Dynamic
seo_workflow	Multi-stage SEO workflows with report generation: seo_performance_audit (GSC analysis + PDF, keyword performance report) and indexing_diagnosis	150-200
query_knowledge_base	RAG Search across SEO knowledge base: Blog articles, documentation, Google guidelines — semantic full-text search by relevance and recency	2

Google & Project Tools (5)

These tools access your own Google data and use no credits. Prerequisite: Google OAuth must be set up under Account > Google Connections.

Tool	Description	Credits
list_projects	List EEAT projects with scores, status, and competitor counts	Free
get_project	Get project details including competitors and Google connection status (GSC/GA4)	Free
get_google_connections	Show connected Google Search Console and Analytics 4 properties plus GSC-GA4 pairings	Free
query_search_console	Query Google Search Console: keywords, pages, countries, devices. Property is auto-detected.	Free
query_analytics	Query Google Analytics 4: traffic overview, top pages, traffic sources, or e-commerce revenue. Property is auto-detected.	Free

Skills & Workflows

Skills are ready-made SEO workflows with methodology, steps, and quality gates. In SEO Copilot Chat they are @-command triggered. Via MCP you will be notified about the get_skill-tool loaded.

In Copilot Chat: Type @ to open the workflow menu. Example: @full-seo-audit example.com Per MCP Tool: get_skill(name="list")

Workflow	Description	Credits (approx.)
@full-seo-audit	Complete Audit: sitemap crawl, PageSpeed/CWV, structured data, hreflang, backlinks, keywords, competitors — with P1/P2/P3 prioritization and 30-60-90 day roadmap	300–500
@quick-seo-audit	Quick Audit: 100-page sample, PageSpeed, core checks, health score — ideal for initial assessment or monitoring	80–120
@seo-audit	Standard SEO Audit: traffic, keywords, on-page, backlinks, competitors — using the 4-phase Neuro-SEO approach	80–120
@keyword-optimization	Keyword optimization: Live SERP check, GSC data, close-variant analysis, page crawl, OnPage Score, prioritized strategy	55–70
@keyword-research	Keyword research with search volume validation, intent classification, cluster building, and quick-win identification	20–40
@keyword-performance-report	Keyword Performance Deep-Dive: ranking distribution, intent mapping, CTR benchmarking, quick-win prioritization, cannibalization	20–30
@seo-potential-report	Potential Analysis with CTR Model, Cluster Breakdown, Lead Calculation, SEA Equivalence, Phase Offer, and ROI	50–80
@competitor-analysis	Competitor Comparison: keyword gaps, traffic comparison, backlink authority, ranking distribution	40–60
@traffic-analysis	Traffic Analysis with Historical Trends, SEA Equivalency Calculation, and Growth Forecast	15–30
@gsc-report	Google Search Console Report: Top Queries, Pages, CTR Benchmarking against Keyword Study 2026, Quick Wins	0
@site-health-check	Website Health Check: broken links, on-page issues, crawlability, indexation	30–50
@seo-structure-check	Technical SEO Structure Check: URL Routing, Canonical URLs, Sitemap, robots.txt, Hreflang	30–50

Call workflow

In SEO Copilot Chat

Type @ in the chat input field — a dropdown shows all available workflows:

# Beispiele fuer den Copilot Chat: @full-seo-audit example.com @quick-seo-audit example.com @keyword-optimization "Ehering aus Gold" example.com @seo-potential-report example.com DE-Markt

Per MCP Tool (Claude Code, Cursor, etc.)

Use the get_skill-tool to load the workflow guide:

# Alle verfuegbaren Skills anzeigen: get_skill(name="list") # Einen Skill laden (z.B. Full SEO Audit): get_skill(name="full-seo-audit") # Oder direkt im Prompt: # "Lade den full-seo-audit Skill und fuehre ihn fuer example.com aus" # monatliches SEA-Budget 20.000 EUR, B2B Industrie"

Skills run fully automated. Claude loads the skill, executes all necessary MCP tool calls, and delivers a structured report — no manual steps required.

Setup: Remote Server (recommended)

The remote server runs on our infrastructure. You don't need to install anything. Simply add the server URL to your MCP configuration.

Claude Code CLI

# PowerShell / Windows (mit API-Key, alle 32 Tools verfuegbar): claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_your_key" # PowerShell / Windows (ohne API-Key, nur 8 kostenlose Tools): claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp

Wichtig fuer PowerShell: Nutze den Befehl als Einzeiler. Der Backslash \ ist dort keine gueltige Zeilenfortsetzung fuer claude mcp add und fuehrt leicht zu Parser-Fehlern.

JSON configuration (settings.json / mcp_servers.json)

For Cursor, VS Code and other clients that use a JSON configuration file:

{ "mcpServers": { "visiblyai": { "type": "http", "url": "https://mcp.visibly-ai.com/mcp", "headers": { "Authorization": "Bearer lc_your_key" } } } }

Replace lc_your_key with your real API key from Account > API Keys. Without the headers-Free plan: only 8 free tools available.

Reconnecting...

After adding, you can test the connection directly in the chat:

# Kontostand und verfuegbare Credits pruefen: # Frage Claude: "Wie viele Credits habe ich noch? Nutze das get_account_info Tool." # Kostenlose URL-Analyse ohne Key: # Frage Claude: "Analysiere die URL-Struktur von https://example.com/produkte/seo-tools"

Setup: pip install

Install the package locally and register it as a stdio transport. Suitable if you want to run or customize the server locally.

Installation and registration

# Paket installieren: pip install visiblyai-mcp-server # In Claude Code registrieren (PowerShell / Windows): claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- visiblyai-mcp-server

JSON configuration (stdio)

{ "mcpServers": { "visiblyai": { "type": "stdio", "command": "visiblyai-mcp-server", "env": { "VISIBLYAI_API_KEY": "lc_your_key" } } } }

The stdio transport starts the server as a local process. The remote transport (HTTP) is easier for most users as it requires no local installation.

Setup: uvx (without installation)

With uvx you can run the server directly without installing it first. The package is automatically fetched on each start.

Claude Code CLI with uvx

# Direkt ausfuehren ohne vorherige Installation (PowerShell / Windows): claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- uvx visiblyai-mcp-server

JSON configuration (uvx)

{ "mcpServers": { "visiblyai": { "type": "stdio", "command": "uvx", "args": ["visiblyai-mcp-server"], "env": { "VISIBLYAI_API_KEY": "lc_your_key" } } } }

uvx requires uv as a package manager. If not present, install it with pip install uv or visit docs.astral.sh/uv.

Authentication

The MCP server accepts a Bearer token in the Authorization header:

Authorization: Bearer lc_your_api_key_here

You manage your API keys under /account/api-keys.

Key format

Property	Value
Prefix	lc_
Example	lc_a1b2c3d4e5f6789...
Create	Account > API Keys
Visibility	Shown only once upon creation

Access levels

Scenario	Available Tools
Title	8 free tools (classify_keywords_simple, seo_checklist, seo_guidance, get_google_guidelines, get_skill, analyze_url_structure, get_account_info, list_locations)
With API key, sufficient credits	All 32 tools
With API key, no credits	8 free tools + 5 Google/project tools + error message for premium tools

Inactive or deleted API keys are immediately rejected with error code -32001 (Authentication required). Each API key is tied to an account and has access only to that account's credits.

Created on

The MCP server limits the number of requests per time window to ensure fair usage.

Generic	Value	Base
Requests per minute	60	Per API key (in-memory)
Requests per minute (anonymous)	10	Per IP address

When exceeded, the server returns the JSON-RPC error code -32000 (Rate limit exceeded). Wait briefly and send the request again.

Rate limits are held in memory and reset when the server restarts. They are isolated per API key so another user cannot affect your limit.

Error Responses

The MCP server returns errors as JSON-RPC error objects:

{ "jsonrpc": "2.0", "id": 1, "error": { "code": -32001, "message": "Authentication required. Provide a valid API key." } }

en	Meaning	Cause
-32700	Parse error	Your analyses cannot be restored
-32600	Invalid request	The JSON request does not conform to the JSON-RPC 2.0 format
-32601	Document not found.	The requested tool or method does not exist
-32602	Invalid params	A required parameter is missing or has an invalid value
-32603	Internal error	Internal server error while processing the request
-32001	Premium subscription required	No or invalid API key provided. Tool requires authentication.
-32002	Insufficient credits	Not enough credits for this action. Top up credits or upgrade your subscription.
-32000	Rate limit exceeded	Too many registrations. Please try again later.

Credit System

Premium tools consume credits from your account. The number of credits deducted depends on the scope of the query.

Credit deduction

Pricing model	Description	Affected tools
Free	No credit deduction. No API key required.	seo_checklist, seo_guidance, analyze_url_structure, get_account_info, list_locations, list_projects, get_project, get_google_connections, query_search_console, query_analytics
Dynamic	Credit deduction based on data volume of the response (number of keywords, domains, data points)	classify_keywords_advanced, get_traffic_snapshot, get_historical_traffic, get_keywords, get_competitors, get_backlinks, get_referring_domains, validate_keywords, seo_agent
5	Fixed Rate: 5 Credits per call	check_pagespeed, check_structured_data
10	Fixed Rate: 10 Credits per call	check_hreflang
15	Fixed price: 15 credits per call	onpage_analysis, check_serp
15-60	Tiered pricing: 15 credits for small websites, up to 60 credits for large crawls	crawl_website
20	Fixed price: 20 credits per call	check_links, audit_sitemap
150-200	Multi-step workflow with report: 150 credits (performance audit), 200 credits (indexing diagnosis)	seo_workflow

Check account balance

Check your balance anytime with the free get_account_info-tool:

# Frage Claude Code im Chat: # "Wie viele Credits habe ich noch auf meinem visiblyai-Konto?" # Claude ruft automatisch get_account_info auf und zeigt dir: # - Verfuegbare Credits # - Abo-Stufe (Free / Standard / Pro / Agency) # - Kontoinformationen

Subscription tiers

Tier	Credits / month	Projects
Free	0	1
Standard	2.500	3
Pro	10.000	10
Agency	50.000	50

Credits are renewed at the start of each billing period and do not roll over to the next period. Unused credits are not carried forward.

Table of Contents