visiblyai-mcp-server 0.5.2

MCP server for VisiblyAI SEO tools - free local tools + paid API-powered SEO analysis

VisiblyAI MCP Server

SEO tools for Claude Code. Free local tools + paid API-powered analysis.

Free tools (no API key needed): keyword classifier, SEO checklists, best practices, URL analysis, Google guidelines, workflow skills.

Paid tools (require API key + credits): traffic analysis, keyword research, backlinks, competitors, OnPage SEO audit, PageSpeed/Core Web Vitals, SERP analysis, sitemap audit, structured data validation, hreflang checks, link checking, SEO agents, SEO workflows, advanced keyword classification.

Quick Start

Option 1: Remote server (zero install, recommended)

No Python or pip needed. Just add a URL to your Claude Code config:

# With API key (all 32 tools):
claude mcp add --transport http \
  --header "Authorization: Bearer lc_your_key" \
  visiblyai https://mcp.visibly-ai.com/mcp

# Without API key (8 free tools only):
claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp

Option 2: uvx (local, no install needed)

claude mcp add --transport stdio \
  --env VISIBLYAI_API_KEY=lc_your_key \
  visiblyai -- uvx visiblyai-mcp-server

Option 3: pip install (local)

pip install visiblyai-mcp-server
claude mcp add --transport stdio \
  --env VISIBLYAI_API_KEY=lc_your_key \
  visiblyai -- visiblyai-mcp-server

Then restart Claude Code.

No API key? Free tools work without one. Get an API key at antonioblago.com/register to unlock paid tools.

Tools

Free (local, no credits) — 8 tools

Tool	Description
classify_keywords_simple	Classify keywords by intent, funnel stage, brand type, topic (local regex, DE+EN)
seo_checklist	5 checklists: general, blog, ecommerce, discover, backlink
seo_guidance	Best practices: title tags, EEAT, Core Web Vitals, schema, and more
get_google_guidelines	Official Google Search guidelines by category (scraped weekly)
get_skill	Fetch SEO workflow guides: audit, keyword research, competitor analysis
analyze_url_structure	Check URL SEO-friendliness
get_account_info	Check your credit balance and tier
list_locations	Available countries for paid tools

Paid (API-powered, uses credits) — 19 tools

Tool	Credits	Description
classify_keywords_advanced	varies	Keyword classification with DataForSEO Search Intent API + regex (more accurate intent)
get_traffic_snapshot	varies	Current organic/paid traffic for a domain
get_historical_traffic	varies	Traffic trends (up to 5 years)
get_keywords	varies	Top ranking keywords with volume and position
get_competitors	varies	Competitor domains by keyword overlap
get_backlinks	varies	Backlink profile with Domain Rating
get_referring_domains	varies	Referring domains with authority scores
validate_keywords	varies	Search volume, competition, CPC for keyword list
crawl_website	15-60	Live crawl + optional 24-point OnPage analysis
onpage_analysis	15	Full 24-point OnPage SEO audit
check_serp	15	Live Google SERP results for a keyword: top organic results with position, URL, domain
check_pagespeed	5	Google PageSpeed Insights + Core Web Vitals: LCP, CLS, TBT, performance score
audit_sitemap	20	XML sitemap audit: total URLs, duplicates, broken links, lastmod coverage
check_structured_data	5	JSON-LD and microdata validation: schema types, required fields, errors
check_hreflang	10	Hreflang validation: x-default, language codes, bidirectional linking
check_links	20	Broken link detection on a page
seo_agent	varies	Run specialized SEO agents: analyst, strategist, copywriter, consultant
seo_workflow	150-200	Multi-step SEO workflows: seo_performance_audit, indexing_diagnosis
query_knowledge_base	2	Semantic RAG search over SEO knowledge base, blog articles, Google guidelines

Google & Project (API key required, 0 credits) — 5 tools

These tools use your own Google OAuth tokens connected via the VisiblyAI platform.

Tool	Description
list_projects	List your EEAT projects with scores and status
get_project	Get project details, competitors, and Google connections
get_google_connections	Show connected GSC/GA4 properties and pairings
query_search_console	Query GSC: clicks, impressions, CTR, position by query/page/country/device
query_analytics	Query GA4: traffic overview, top pages, traffic sources, revenue

Examples

In Claude Code, just ask naturally:

> Classify these keywords: "seo tool kaufen", "was ist seo", "seo agentur berlin"

> Give me the blog SEO checklist in German

> What are the best practices for title tags?

> What does Google say about EEAT?

> Get the top keywords for example.com

> Run an OnPage SEO analysis on https://example.com/page for the keyword "seo tool"

> Run a full SEO performance audit for example.com (project_id: 12)

> Search the knowledge base for structured data best practices

Configuration

Environment Variable

Variable	Required	Description
VISIBLYAI_API_KEY	For paid tools	API key from antonioblago.com

Getting an API Key

1. Sign up at antonioblago.com/register
2. Go to Account > API Keys
3. Create a new key (starts with lc_)
4. Add it to your Claude Code MCP config

Subscription Tiers

Tier	Credits/month	Price
Free	0	Free
Standard	2,500	Paid
Pro	10,000	Paid
Agency	50,000	Paid

Requirements

• Python 3.10+
• Claude Code CLI

License

MIT