Skip to content
MCP server

Fbc Guard

Static checks for Meta fbclid and _fbc cookie code that cause modified click ID warnings

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Fbc Guard

Fbc Guard is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

One wrong line in landing-page cookie code can send a conversion to the wrong ad. This checker reads source text only, runs nothing and sends nothing to Meta, then tests it against seven rules, each tagged as stated by Meta, derived, or observed in practice.

The rules: a new fbclid must overwrite an older _fbc cookie; do not decode, lowercase or truncate the click ID; creationTime for _fbc and _fbp must be milliseconds, not seconds; and subdomainIndex should not be hard-coded, which is a warning only. Results are pass, fail, unknown or not_applicable, with exit codes for CI.

Two tools exist: check_fbc_code for pasted code and check_fbc_url, which fetches a public page plus its same-origin scripts. The README is candid that a pass means no known mistake was found in recognised shapes. Minified or runtime-built code can hide problems, and Meta does not document what triggers the diagnostic. MIT licensed, Node 18+.

Install

Run in a terminal

claude mcp add fbc-guard -- npx -y mcp-server-fbc-guard

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "fbc-guard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fbc-guard"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "fbc-guard": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fbc-guard"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "fbc-guard": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fbc-guard"
      ]
    }
  }
}

Tools this server provides (2)

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

check_fbc_code
Runs every rule on HTML or JavaScript you pass.
check_fbc_url
Fetches a page and same-origin scripts, then runs every rule.

What it does

Seven rules
Cover overwrite, decoding, case, truncation, units and index.
URL checking
Fetches a page and same-origin scripts.
Cites basis
Each rule says whether Meta states it.
CI exit codes
Usable before a deploy.
Startup selftest
Refuses to run if its controls fail.
Library export
Importable without starting the server.

Good for

  • Review tracking code an assistant just wrote
  • Diagnose a modified fbclid warning
  • Gate deploys on click ID handling
  • Check a landing page and its scripts

Pricing

Open source

MIT licensed

Prices change. Check adsandcode.com before you buy.

Fbc Guard FAQ

Does it run my code?

No, it is static analysis of source text.

Does a pass mean the code is correct?

No, only that known mistakes were not found.

Does it contact Meta?

No.

What does it need?

Node.js 18 or later.

Is Fbc Guard free?

Yes. Fbc Guard is open source, so you can use and self-host it for free.

How do I add Fbc Guard to Claude Code?

Run this command in your terminal: claude mcp add fbc-guard -- npx -y mcp-server-fbc-guard

What are the best alternatives to Fbc Guard?

The closest alternatives to Fbc Guard are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Fbc Guard

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools