How do I install Optiqra?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Optiqra need an API key?

The publisher lists these environment variables: OPTIQRA_BASE_URL, OPTIQRA_PROVIDER_API_KEY, OPTIQRA_TIMEOUT_MS.

What transport does Optiqra use?

Optiqra runs locally over stdio.

Optiqra

by io.github.armin5872

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

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

npx -y [email protected]

Credentials from the publisher

OPTIQRA_BASE_URL — Base URL of the OptiQra instance to call. Defaults to https://optiqra.vercel.app.
OPTIQRA_PROVIDER_API_KEY — Default AI-provider API key used by the ai-fix/ai-insights/ai-test tools if the caller doesn't pass one.
OPTIQRA_TIMEOUT_MS — Request timeout in milliseconds. Defaults to 120000.

Provider

Claude Code

OPTIQRA_BASE_URL=<value> OPTIQRA_PROVIDER_API_KEY=<secret> OPTIQRA_TIMEOUT_MS=<value> claude mcp add io.github.armin5872-optiqra-mcp -- npx -y [email protected]

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.armin5872-optiqra-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OPTIQRA_BASE_URL": "<value>",
        "OPTIQRA_PROVIDER_API_KEY": "<secret>",
        "OPTIQRA_TIMEOUT_MS": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install Optiqra?: Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Optiqra need an API key?: The publisher lists these environment variables: OPTIQRA_BASE_URL, OPTIQRA_PROVIDER_API_KEY, OPTIQRA_TIMEOUT_MS.
What transport does Optiqra use?: Optiqra runs locally over stdio.
When was Optiqra last checked?: Last checked 2026-10-16. MCP server exposing OptiQra's website audit tools: SEO, GEO, AEO, and AI-generated fixes.

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:

Tool	OptiQra endpoint	What it does
`optiqra_analyze`	`POST /api/analyze`	Crawls a URL and runs the full SEO/GEO/AEO/perf/a11y/security audit
`optiqra_ai_fix`	`POST /api/ai-fix`	Generates an AI-written fix for one issue from a report
`optiqra_ai_insights`	`POST /api/ai-insights`	Generates a site-wide AI strategy summary across a full report
`optiqra_ai_test`	`POST /api/ai-test`	Verifies 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)

Variable	Required	Purpose
`OPTIQRA_BASE_URL`	No	Base URL of the OptiQra instance to call. Defaults to `https://optiqra.vercel.app`.
`OPTIQRA_PROVIDER_API_KEY`	No	A 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_MS`	No	Request 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.