mcpField
G
goflag

goflag

Local
goflag.techBusiness & Marketing1Updated 2d ago
RepositoryVisit website

About goflag

@goflag/mcp is a local MCP server for agents auditing the SEO and internationalization of sites under development. It checks local or accessible preview URLs, reports findings with rule sources, and can compare results with a saved baseline.

Key features

  1. 01Audit site SEO and localization
  2. 02Compare findings with a saved baseline
  3. 03Explain rules with their sources
  4. 04List rules by scope
  5. 05Report crawl progress and cancellation

Use cases

  1. 01Check a local development site after edits
  2. 02Find translation gaps and broken links
  3. 03Review changes against a prior audit
  4. 04Look up the basis for an audit finding

MCP support

Provides four read-only MCP tools: audit_site, compare_to_baseline, explain_rule, and list_rules. It runs locally over stdio and does not start commands, write baselines, or provide remote mode.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tancredesimonin-goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}
Run commandnpx -y @goflag/mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@goflag/mcp0.1.2

Tools

4

Saved tool list · updated 1d ago

ParameterTypeRequiredDescription
urlstringYesThe site to audit, http or https. A dev server's URL works: http://localhost:3000.
staticbooleanNoNever launch Chromium; judge the server-rendered HTML only.
localesarrayNoLocales the site serves, e.g. ["en", "fr"], when its sitemap does not say.
maxPagesintegerNoPage budget. Default 50.
advisoriesbooleanNoAlso return the questions a linter cannot settle, with their evidence, for you to judge.
checkExternalbooleanNoAlso probe links to other sites. Off by default: slow, and not your site's fault.
expectIndexingenumNo"no" for a staging or preview host that must stay out of search indexes.no | yes

Details

From the project README

@goflag/mcp

goflag as an MCP server. An agent audits the site it is editing — a dev server on localhost, a preview behind a VPN — and reads each rule with the documents that require it.

It runs locally, over stdio, on the same engine as @goflag/cli: an answer here is the answer goflag would print.

Getting started

Claude Code:

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

Cursor (.cursor/mcp.json), VS Code (.vscode/mcp.json, under servers) and other clients take the same command:

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

Then ask your agent to check the SEO of what it just changed: it starts the dev server, calls audit_site on its URL, fixes what is new, and calls it again.

Tools

All four are read-only: none writes to disk or to the site.

ToolInputReturns
audit_siteurl; optional maxPages (default 50), locales, expectIndexing, static, advisories, checkExternal (default off)The findings rolled up by rule with their rigor, translation holes, broken links, the coverage, and the exit code the CLI would return
compare_to_baselinethe same, plus baseline: a JSON report saved by goflag --report or --update-baselineWhat is new, what was resolved, how many findings are unchanged
explain_ruleid, from a findingWhat the rule checks, why, its rigor, the documents behind it, and its page on goflag.tech
list_rulesoptional scope: page, site or proseEvery rule with its scope, severity and rigor

audit_site reports crawl progress to a client that asks for it, and stops when the call is cancelled.

What it does not do

  • No headers. A token passed as a tool argument would sit in the agent's transcript. Audit a protected preview with the CLI: goflag <url> --header "<name>: <value>".
  • No command to run. The agent starts its own dev server; this server never executes one.
  • No baseline written. Capture one with goflag <url> --update-baseline --baseline .goflag/baseline.json; compare_to_baseline only reads it, and refuses a file that is not a goflag report without quoting it.
  • No remote mode. It runs where the agent runs — which is why it can see localhost.

Requirements

Node 22 or later. A page that renders in the browser is audited in Chromium, through the playwright package; without it, or with static: true, the server-rendered HTML is judged instead.

Learn more

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.