@lumar/ai-visibility-mcp-server

MCP server for Lumar AI Visibility — monitor your brand's presence across AI-powered search engines and assistants.

Track how AI providers like ChatGPT, Gemini, Perplexity, and others mention, cite, and rank your brand. Analyze visibility scores, citations, mentions, sentiment, and competitive positioning over time.

Requirements

• Node.js >= 20
• A Lumar account with AI Visibility enabled

Setup

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "lumar-ai-visibility": {
      "command": "npx",
      "args": ["-y", "@lumar/ai-visibility-mcp-server"]
    }
  }
}

Authentication

On first use, the server will open your browser to log in via your Lumar account. Tokens are cached locally at ~/.config/lumar/ai-visibility-mcp/tokens.json and refreshed automatically.

No API keys or secrets are needed.

Environment Variables

| Variable | Description | Default | | ----------- | ---------------------------------------------------- | ------------ | | LUMAR_ENV | Environment: production, staging, or localhost | production |

Available Tools

| Tool | Description | | ------------------------ | ------------------------------------------ | | list_projects | List AI Visibility projects | | create_project | Create a project with a primary brand | | delete_project | Delete a project | | list_topics | List topics with visibility metrics | | search_topics | Search topics by name | | create_topic | Create a topic under a project | | delete_topic | Delete a topic | | list_prompts | List prompts with analytics | | create_prompt | Create a prompt under a topic | | delete_prompt | Delete a prompt | | list_brands | List/search brands with visibility metrics | | get_top_brands | Top brands ranked by visibility score | | list_brand_citations | Brand citations with URL metrics | | list_brand_mentions | Brand mentions with sentiment | | list_ai_providers | Available AI providers | | get_visibility_scores | Time-series visibility scores | | list_prompt_runs | Prompt execution runs | | get_prompt_run_details | Full AI response for a run |

License

MIT