Quick Install
Connect Claude Code to the Visibly AI MCP server in four steps, or skip the manual work and hand an AI assistant the install prompt below.
Looking for the full tool reference? See the MCP Server documentation.
Install Claude Code
Claude Code is the CLI for Claude. Requires Node.js 18 or higher.
npm install -g @anthropic-ai/claude-code
Connect the MCP
Choose one option. Option A needs no local install.
Option A. Remote server (recommended)
With an API key, all 33 tools are available:
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" visiblyai https://mcp.visibly-ai.com/mcp
Without a key, the 8 free tools still work:
claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp
Option B. uvx (local, no install needed)
Requires Python 3.10+ with uv installed (pip install uv).
claude mcp add --transport stdio --env VISIBLYAI_API_KEY=YOUR_API_KEY visiblyai -- uvx visiblyai-mcp-server
Option C. pip install (local)
pip install visiblyai-mcp-server
claude mcp add --transport stdio --env VISIBLYAI_API_KEY=YOUR_API_KEY visiblyai -- visiblyai-mcp-server
Get an API key
Register at app.visibly-ai.com/register, then go to Settings > API Key & MCP and create a key. It starts with lc_.
Verify
Restart Claude Code, then run:
/mcp
Confirm visiblyai shows up as connected, then try an example prompt: "Analyze the SEO of example.com".
Install Prompt
Don't want to run the commands yourself? Copy this prompt into Claude Code or another AI assistant with shell access. It checks your setup, asks for your API key, and runs the install for you.
You are an AI assistant with shell or terminal access. Help me install and configure the Visibly AI MCP server for Claude Code. Work through these steps one at a time, and ask before running any command that changes my system.
1. Check whether the `claude` CLI is already installed by running `claude --version`. If it is missing, tell me to install it first with `npm install -g @anthropic-ai/claude-code` (requires Node.js 18 or newer), and wait for my confirmation before continuing.
2. Ask me for my Visibly AI API key. It starts with `lc_`, and I can find it at https://app.visibly-ai.com/settings under "API-Key & MCP". If I don't have one yet or don't want to use one right now, continue without it: the remote MCP server still works without a key, just with the 8 free tools instead of all 33.
3. Depending on my answer, run exactly one of these commands:
- With an API key: claude mcp add --transport http --header "Authorization: Bearer MY_API_KEY" visiblyai https://mcp.visibly-ai.com/mcp (replace MY_API_KEY with the key I gave you)
- Without an API key: claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp
4. Ask me to restart Claude Code, then tell me to run /mcp and confirm that "visiblyai" is listed as connected.
5. Once it is connected, test it: ask me to try a free tool, for example "Use get_google_guidelines to show Google's EEAT guidelines," and confirm the tool call succeeds.
6. If a tool call fails with a 401 or "unauthorized" error, check that the API key starts with lc_ and that the header is exactly Authorization: Bearer <key> with no typos, then try again.
Report back after each step what you found and what you did.