@vectraseo/mcp

@vectraseo/mcp

MCP server for VectraSEO — create, onboard and manage SEO projects from any MCP client.

The real server is remote and speaks Streamable HTTP. If your client supports HTTP transports, connect to it directly and skip this package:

claude mcp add --transport http vectraseo https://api.vectraseo.com/mcp \
  --header "x-api-key: vsak_..."

This package exists for clients that can only launch a stdio subprocess. It is a zero-dependency bridge: it forwards JSON-RPC between stdin/stdout and the remote endpoint. It carries no tool list of its own, so what you get is always what the server currently serves.

Usage

{
  "mcpServers": {
    "vectraseo": {
      "command": "npx",
      "args": ["-y", "@vectraseo/mcp"],
      "env": { "VECTRASEO_API_KEY": "vsak_..." }
    }
  }
}

Env var	Required	Purpose
VECTRASEO_API_KEY	yes	An account API key (vsak_). Create one at Settings → API keys. A per-project vsk_ key is read-only and is rejected.
VECTRASEO_MCP_URL	no	Override the endpoint. Defaults to https://api.vectraseo.com/mcp.

Scopes

A key carries only the permissions you grant it, and they are fixed at creation. Grant the least the integration needs:

Scope	Lets the assistant
projects:read	Read projects, posts, monitors, scans, jobs. Always granted.
recommendations:read	Open a Search Console recommendation's detail, and act on one.
projects:write	Create projects and edit their settings. Also removes recoverable configuration: a competitor, an AI-visibility monitor, a tracked rank keyword, or switches the content schedule off.
jobs:write	Start content runs and site scans. Consumes plan quota.
content:publish	Publish to your connected CMS. Writes to your live site.
traffic:write	Push your own aggregated per-page traffic for a UTC day (e.g. a nightly CDN log rollup). A replay replaces that day.
gaps:delete	Permanently delete a suggested topic. The only scope that exists just to delete — prefer rejecting one.

No key can delete a project, a post or a site-health monitor, reveal CMS credentials, touch billing, or manage API keys — those stay signed-in actions in the dashboard.

Full documentation: https://vectraseo.com/docs/mcp