Lumar MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Lumar MCP Server
An MCP (Model Context Protocol) server that wraps the Lumar GraphQL API, built with FastMCP.
This lets any MCP-compatible AI assistant (Claude, etc.) query your Lumar SEO crawl data conversationally — list projects, inspect crawls, pull URL-level metrics, generate reports, and download raw data.
Tools
Tool | Description |
| List all accessible Lumar accounts |
| List projects within an account |
| Get project details and recent crawls |
| List crawls for a project |
| Get details for a specific crawl |
| Get report statistics and first 100 URLs |
| Get URL-level SEO metrics with filtering and pagination |
| Trigger a downloadable report file |
| Check download status / get URL |
| Get Parquet download URLs for full crawl data |
| Execute any arbitrary GraphQL query |
Setup
1. Get Lumar API credentials
In your Lumar account, create a User Key to get a User Key ID and Secret. See Lumar API docs for details.
2. Install
# With uv (recommended)
uv pip install -e .
# Or with pip
pip install -e .3. Configure credentials
Set environment variables:
export LUMAR_USER_KEY_ID="your-key-id"
export LUMAR_SECRET="your-secret"4. Run
# As a module
python -m lumar_mcp.server
# Or via the entry point
lumar-mcpClaude Desktop configuration
Add this to your Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"lumar": {
"command": "python",
"args": ["-m", "lumar_mcp.server"],
"env": {
"LUMAR_USER_KEY_ID": "your-key-id",
"LUMAR_SECRET": "your-secret"
}
}
}
}Or if using uv:
{
"mcpServers": {
"lumar": {
"command": "uv",
"args": ["run", "--directory", "/path/to/lumar-mcp-server", "python", "-m", "lumar_mcp.server"],
"env": {
"LUMAR_USER_KEY_ID": "your-key-id",
"LUMAR_SECRET": "your-secret"
}
}
}
}Example usage
Once connected, you can ask Claude things like:
"List my Lumar accounts and projects"
"Show me the last 5 crawls for project X"
"Get the broken pages report for crawl Y"
"Find all URLs with HTTP 500 errors in the latest crawl"
"Download the raw crawl data as Parquet"
"Generate a report download for indexable pages"
Common report template codes
These are some frequently used Lumar report template codes you can pass to get_report_stats and get_url_data:
indexable_pages— Pages that can be indexednon_indexable_pages— Pages blocked from indexingbroken_pages— Pages returning 4xx/5xx errorshttps_pages— HTTPS page analysisorphaned_google_search_console_pages— Pages in GSC but not found in crawlduplicate_pages— Pages with duplicate contentthin_pages— Pages with low word count
Project structure
lumar-mcp-server/
├── pyproject.toml # Package config and dependencies
├── README.md
└── lumar_mcp/
├── __init__.py
├── client.py # Lumar GraphQL client with auth
├── queries.py # Pre-built GraphQL queries
└── server.py # FastMCP server with all toolsExtending
To add new tools, edit server.py and add a new function decorated with @mcp.tool. Add the corresponding GraphQL query to queries.py. The run_query tool also allows executing arbitrary GraphQL queries for anything not covered by the built-in tools.
References
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.