Skip to content
MCP server

goflag

Audit SEO and translation coverage of the site your coding agent is editing

Runs locally
Install
Platforms
CLI
Runs
Locally
Version
0.1.2
Listing updated
5 days ago

Similar MCP servers

About goflag

goflag is an MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

A hosted audit service cannot see localhost or a preview behind a VPN, but a local server can. goflag's MCP package runs on the developer's machine with the same engine as the goflag CLI, so an answer is the one the CLI would print. The typical loop: the agent starts its dev server, calls audit_site on its URL, fixes what is new and audits again.

Four read-only tools do the work, and nothing is written to disk or the site. audit_site rolls findings up by rule with their rigor, reports translation holes and broken links, and returns the CLI's exit code. compare_to_baseline reads a JSON report saved by the CLI and shows what is new and resolved. Defaults favor speed: 50 pages and no external link checks unless checkExternal is set.

Protected previews are handled in configuration rather than tool arguments. GOFLAG_HEADERS and GOFLAG_HEADERS_ORIGIN attach a header such as a Vercel protection bypass only to the origins you name, and the agent sees header names but never values. The package needs Node 22 or later and has no remote mode.

Install

Run in a terminal

claude mcp add goflag -- npx -y @goflag/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "goflag": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

audit_site
Crawls a URL and returns findings rolled up by rule, translation holes, links and coverage.
compare_to_baseline
Compares an audit against a saved CLI report: new, resolved and unchanged findings.
explain_rule
Explains a rule, its rigor and the documents behind it.
list_rules
Lists every rule with scope, severity and rigor.

What it does

Local-site audits
Audits localhost or a protected preview that hosted tools cannot reach.
Rules with sources
explain_rule gives what a rule checks, why, and the documents behind it.
Baseline comparison
Shows what is new, resolved and unchanged against a saved report.
Translation holes
Reports i18n gaps alongside SEO findings and broken links.
Origin-bound headers
Auth headers go only to configured origins and never appear in results.
Read-only
None of the four tools writes to disk or to the site.

Good for

  • Check SEO after each change an agent makes
  • Catch missing translations across locales
  • Confirm a change did not add findings against a baseline
  • Audit a Vercel preview behind a bypass header
  • Look up why a rule exists before fixing it

goflag FAQ

Can it audit localhost?

Yes. It runs where the agent runs, which is why it can reach a dev server on localhost.

Does it start my dev server?

No. The agent starts its own dev server; this server never executes one.

How are secrets handled?

Headers are set in the server's environment, bound to named origins; a value never appears in a result.

What Node version is needed?

Node 22 or later.

How do I add goflag to Claude Code?

Run this command in your terminal: claude mcp add goflag -- npx -y @goflag/mcp

What are the best alternatives to goflag?

The closest alternatives to goflag are Next.js SEO Audit, Pageaudit, RankCLI, TraceFlow Lens and Contentgate.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers