VisiblyAI MCP Server

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

Production routing: MCP clients connect to https://mcp.visibly-ai.com/mcp. The installed package sends API-backed tool calls to https://app.visibly-ai.com/api/v1/mcp. The marketing domain visibly-ai.com is not an API host.

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 48 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 app.visibly-ai.com/register to unlock paid tools.

Tools

Free (local, no credits) — 8 tools

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

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

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

Project data & content (API key required, 0 credits, read-only) — 15 tools

Nothing here writes back to visibly or spends credits. Team members read on the project owner's data; area roles apply (analytics / seo_tools / content).

Limits: 60 requests/minute per key, responses up to 256 KiB (lists continue via page.next_offset), requests up to 512 KiB. Errors come as {"error": "<code>", "message": ...} (not_found, role_no_access, rate_limited, result_too_large, ...).

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

Getting an API Key

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

Subscription Tiers

Requirements

• Python 3.10+
• Claude Code CLI

Development

Run the test suite with PYTHONPATH=src, not a plain python -m pytest:

PYTHONPATH=src python -m pytest tests -q --ignore=tests/integration

Without PYTHONPATH=src, python -m pytest can resolve visiblyai_mcp against an installed package version instead of the local src/ checkout, so tests run against the wrong code. --ignore=tests/integration skips the tests that need a live API key.

License

MIT