MCP Server

Quick Start

Prefer a condensed walkthrough with copy-paste commands and a downloadable install prompt? See the Quick Install Guide.

Available Tools

The MCP server provides 33 tools. 8 free tools work without an API key. 20 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)

Premium Tools (20)

Google & Project Tools (5)

Skills & Workflows

Skills are ready-made SEO workflows with methodology, steps, and quality gates. In the SEO Copilot chat they are triggered with an @ command. Via MCP they are loaded through the get_skill tool.

Calling a workflow

In SEO Copilot chat

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

# Examples for Copilot chat:
@full-seo-audit example.com
@quick-seo-audit example.com
@keyword-optimization "gold wedding ring" example.com
@seo-potential-report example.com US market

Via MCP tool (Claude Code, Cursor, etc.)

Use the get_skill tool to load the workflow guide:

# Show all available skills:
get_skill(name="list")

# Load a skill (e.g. Full SEO Audit):
get_skill(name="full-seo-audit")

# Or directly in the prompt:
# "Load the full-seo-audit skill and run it for example.com,
#  monthly SEA budget $20,000, B2B industry"

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 (with API key, all 33 tools available):
claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_your_key"

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

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"
      }
    }
  }
}

Test the connection

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

# Check balance and available credits:
# Ask Claude: "How many credits do I have left? Use the get_account_info tool."

# Free URL analysis without a key:
# Ask Claude: "Analyze the URL structure of https://example.com/products/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

# Install the package:
pip install visiblyai-mcp-server

# Register in Claude Code (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"
      }
    }
  }
}

Setup: uvx

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

# Run directly without prior 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"
      }
    }
  }
}

Authentication

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

Authorization: Bearer lc_your_api_key_here

You manage API keys under Settings > API Key & MCP.

Key format

Access levels

Rate Limits

Guideline values: these limits describe the intended usage; hard enforcement may happen at the infrastructure level and can change.

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

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

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."
  }
}

Credit System

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

Credit deduction

Check your balance

Check your balance anytime with the free get_account_info tool:

# Ask Claude Code in the chat:
# "How many credits do I have left on my visiblyai account?"
# Claude automatically calls get_account_info and shows you:
# - Available credits
# - Subscription tier (Free / Standard / Pro / Agency)
# - Account information

Subscription tiers