goflag
Audit SEO and translation coverage of the site your coding agent is editing
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"goflag": {
"command": "npx",
"args": [
"-y",
"@goflag/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"goflag": {
"command": "npx",
"args": [
"-y",
"@goflag/mcp"
]
}
}
}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.