Back to Browse

Optiqra MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server exposing OptiQra's website audit tools: SEO, GEO, AEO, and AI-generated fixes.

About

MCP server exposing OptiQra's website audit tools: SEO, GEO, AEO, and AI-generated fixes.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of the OptiQra instance to call. Defaults to https://optiqra.vercel.app.Optional

Environment variable: OPTIQRA_BASE_URL

Default AI-provider API key used by the ai-fix/ai-insights/ai-test tools if the caller doesn't pass one.Required

Environment variable: OPTIQRA_PROVIDER_API_KEY

Request timeout in milliseconds. Defaults to 120000.Optional

Environment variable: OPTIQRA_TIMEOUT_MS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-armin5872-optiqra-mcp": {
      "env": {
        "OPTIQRA_BASE_URL": "your-optiqra-base-url-here",
        "OPTIQRA_TIMEOUT_MS": "your-optiqra-timeout-ms-here",
        "OPTIQRA_PROVIDER_API_KEY": "your-optiqra-provider-api-key-here"
      },
      "args": [
        "-y",
        "optiqra-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

optiqra-mcp

An MCP (Model Context Protocol) server that exposes every tool in OptiQra's API to MCP-compatible AI clients (Claude Desktop, Claude Code, Cursor, etc.).

OptiQra has four HTTP endpoints. This server wraps all four as MCP tools:

ToolOptiQra endpointWhat it does
optiqra_analyzePOST /api/analyzeCrawls a URL and runs the full SEO/GEO/AEO/perf/a11y/security audit
optiqra_ai_fixPOST /api/ai-fixGenerates an AI-written fix for one issue from a report
optiqra_ai_insightsPOST /api/ai-insightsGenerates a site-wide AI strategy summary across a full report
optiqra_ai_testPOST /api/ai-testVerifies a provider/API key/model combo works before using the two above

By default it talks to the public demo, https://optiqra.vercel.app. Point it at your own deployment (see OptiQra's own DEPLOYMENT.md/Docker setup) with an env var — see below.

Install

npm install

(or, once published, npm install -g optiqra-mcp / run directly with npx optiqra-mcp)

Configuration (environment variables)

VariableRequiredPurpose
OPTIQRA_BASE_URLNoBase URL of the OptiQra instance to call. Defaults to https://optiqra.vercel.app.
OPTIQRA_PROVIDER_API_KEYNoA default AI-provider API key used by optiqra_ai_fix/optiqra_ai_insights/optiqra_ai_test if the model doesn't pass one. Recommended over letting the model handle the key in plaintext.
OPTIQRA_TIMEOUT_MSNoRequest timeout in ms. Defaults to 120000 (full-site crawls can be slow).

Run it standalone

node src/index.js

It speaks MCP over stdio, so you won't see anything happen — it's waiting for an MCP client to connect.

Wire it into an MCP client

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or via claude mcp add for Claude Code):

{
  "mcpServers": {
    "optiqra": {
      "command": "node",
      "args": ["/absolute/path/to/optiqra-mcp/src/index.js"],
      "env": {
        "OPTIQRA_BASE_URL": "https://optiqra.vercel.app",
        "OPTIQRA_PROVIDER_API_KEY": "sk-..."
      }
    }
  }
}

Any other MCP-compatible client (Cursor, Windsurf, etc.) uses the same
`command`/`args`/`env` shape — check that client's docs for where the config
file lives.

## Notes on the AI-key tools

`optiqra_ai_fix`, `optiqra_ai_insights`, and `optiqra_ai_test` all need a
provider API key, exactly like pasting one into OptiQra's own UI — OptiQra's
server forwards it straight to the provider (OpenAI, Anthropic, Google, Groq,
OpenRouter, Mistral, DeepSeek, or xAI) and never stores it. This server does
the same: it never persists keys. Prefer setting `OPTIQRA_PROVIDER_API_KEY`
in your MCP client's env config over having the model pass a key through
chat.

Reviews

No reviews yet

Be the first to review this server!