Skip to content
Back to search

beamfar

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/beamfar--integrations/badge.svg)](/listings/beamfar--integrations)

HTML

<a href="/listings/beamfar--integrations"><img src="/api/listings/beamfar--integrations/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. GitHub Copilot & VS Code (MCP Server)

Add Beamfar in `.vscode/mcp.json` (or install directly from [beamfar.com/mcp-server](https://beamfar.com/mcp-server) / GitHub MCP Registry `com.beamfar/website-monitoring`):

{
  "servers": {
    "beamfar": {
      "type": "http",
      "url": "https://api.beamfar.com/mcp"
    }
  }
}

2. Google Antigravity (Plugin + MCP + Incident Triage Skill)

Includes `.antigravity-plugin/plugin.json`, `mcp_config.json` (`https://api.beamfar.com/mcp`), bundled logo (`assets/logo.png`), and `skills/incident-triage/SKILL.md`.

3. Claude Code (Official Plugin)

claude plugin marketplace add beamfar/integrations
claude plugin install beamfar@beamfar

Run `/beamfar:check-sites` or connect the endpoint directly:

claude mcp add --transport http beamfar https://api.beamfar.com/mcp

4. Google Gemini CLI (Official Extension)

gemini extensions install https://github.com/Beamfar/integrations

Installs the MCP server, `GEMINI.md` triage rules, `incident-triage` skill, and `/beamfar:check-sites`.

5. OpenAI Codex CLI & App (Plugin, `config.toml` & Skill)

codex mcp add beamfar --url https://api.beamfar.com/mcp
codex mcp login beamfar

Or copy [`codex/config.toml`](codex/config.toml) into `~/.codex/config.toml` and [`skills/incident-triage/SKILL.md`](skills/incident-triage/SKILL.md) into `~/.codex/skills/beamfar-incident-triage/SKILL.md`.

6. Claude.ai, ChatGPT & Cursor

- **Claude.ai & Claude Desktop:** Settings -> Connectors -> Add custom connector -> `https://api.beamfar.com/mcp` (OAuth 2.1). - **ChatGPT:** Settings -> Connectors -> Create custom connector -> `https://api.beamfar.com/mcp` (OAuth 2.1). - **Cursor:** Visit [beamfar.com/mcp-server](https://beamfar.com/mcp-server) or [Cursor Directory](https://cursor.directory/plugins/beamfar). - **Official MCP Registry:** `com.beamfar/website-monitoring`.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines
  1. {
  2. "name": "beamfar",
  3. "owner": {
  4. "name": "Beamfar",
  5. "url": "https://beamfar.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "beamfar",
  10. "source": "./",
  11. "description": "Read-only website monitoring for Claude Code: check sites, open incidents, two-region evidence, pre-incident timelines, security findings, and client reports.",
  12. "version": "1.2.0",
  13. "homepage": "https://beamfar.com/mcp-server",
  14. "license": "MIT"
  15. }
  16. ]
  17. }
README.md · README · 109 lines
  1. # Beamfar — AI Assistant Add-ons (Claude Code, GitHub Copilot / VS Code, Google Antigravity, Gemini CLI, OpenAI Codex & MCP)
  2. Connect your AI assistant to [Beamfar](https://beamfar.com/mcp-server)'s hosted, read-only MCP server (`https://api.beamfar.com/mcp`) to check monitored sites, inspect two-region incident evidence, correlate pre-incident DNS/TLS/deploy timelines, review external security findings, and summarise monthly client reports.
  3. - **Read-only by design:** All 12 MCP tools only read stored monitoring observations — nothing can modify sites, monitors, alerts, billing, or status pages.
  4. - **OAuth 2.1 or API key:** Sign in directly via OAuth 2.1 (PKCE S256) in Claude.ai, Claude Code, GitHub Copilot / VS Code, Google Antigravity, ChatGPT, Codex, Cursor, and Gemini CLI, or pass a read-only `BEAMFAR_API_KEY` (`bfk_...`).
  5. - **Included on every plan (Free included):** Works on Free (1 site checked every 5 minutes, 3,000 API/MCP requests per month, 10 requests per minute, no card, no time limit), Solo, Team, Agency, and Agency Plus.
  6. - **EU-hosted Streamable HTTP:** Runs in Falkenstein, Germany (Hetzner) with zero local database or runtime required.
  7. ---
  8. ## Quick Install
  9. ### 1. GitHub Copilot & VS Code (MCP Server)
  10. Add Beamfar in `.vscode/mcp.json` (or install directly from [beamfar.com/mcp-server](https://beamfar.com/mcp-server) / GitHub MCP Registry `com.beamfar/website-monitoring`):
  11. ```json
  12. {
  13. "servers": {
  14. "beamfar": {
  15. "type": "http",
  16. "url": "https://api.beamfar.com/mcp"
  17. }
  18. }
  19. }
  20. ```
  21. ### 2. Google Antigravity (Plugin + MCP + Incident Triage Skill)
  22. Includes `.antigravity-plugin/plugin.json`, `mcp_config.json` (`https://api.beamfar.com/mcp`), bundled logo (`assets/logo.png`), and `skills/incident-triage/SKILL.md`.
  23. ### 3. Claude Code (Official Plugin)
  24. ```bash
  25. claude plugin marketplace add beamfar/integrations
  26. claude plugin install beamfar@beamfar
  27. ```
  28. Run `/beamfar:check-sites` or connect the endpoint directly:
  29. ```bash
  30. claude mcp add --transport http beamfar https://api.beamfar.com/mcp
  31. ```
  32. ### 4. Google Gemini CLI (Official Extension)
  33. ```bash
  34. gemini extensions install https://github.com/Beamfar/integrations
  35. ```
  36. Installs the MCP server, `GEMINI.md` triage rules, `incident-triage` skill, and `/beamfar:check-sites`.
  37. ### 5. OpenAI Codex CLI & App (Plugin, `config.toml` & Skill)
  38. ```bash
  39. codex mcp add beamfar --url https://api.beamfar.com/mcp
  40. codex mcp login beamfar
  41. ```
  42. Or copy [`codex/config.toml`](codex/config.toml) into `~/.codex/config.toml` and [`skills/incident-triage/SKILL.md`](skills/incident-triage/SKILL.md) into `~/.codex/skills/beamfar-incident-triage/SKILL.md`.
  43. ### 6. Claude.ai, ChatGPT & Cursor
  44. - **Claude.ai & Claude Desktop:** Settings -> Connectors -> Add custom connector -> `https://api.beamfar.com/mcp` (OAuth 2.1).
  45. - **ChatGPT:** Settings -> Connectors -> Create custom connector -> `https://api.beamfar.com/mcp` (OAuth 2.1).
  46. - **Cursor:** Visit [beamfar.com/mcp-server](https://beamfar.com/mcp-server) or [Cursor Directory](https://cursor.directory/plugins/beamfar).
  47. - **Official MCP Registry:** `com.beamfar/website-monitoring`.
  48. ---
  49. ## Repository Layout
  50. | Assistant | Manifest / Entry Point | Included Components |
  51. | --- | --- | --- |
  52. | **Google Antigravity** | `.antigravity-plugin/plugin.json`, `mcp_config.json`, `assets/logo.png` | Hosted MCP server, `incident-triage` skill, starter prompts |
  53. | **GitHub Copilot / VS Code** | `.vscode/mcp.json` (or `com.beamfar/website-monitoring` via GitHub MCP Registry) | Hosted Streamable HTTP OAuth 2.1 MCP server |
  54. | **Claude Code** | `.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `.mcp.json` | Hosted MCP server, `/beamfar:check-sites` command, `incident-triage` skill |
  55. | **Gemini CLI** | `gemini-extension.json`, `GEMINI.md` | Hosted MCP server, context rules, `/beamfar:check-sites` command, `incident-triage` skill |
  56. | **OpenAI Codex** | `plugin.json`, `mcp.json`, `AGENTS.md`, `codex/config.toml` | Hosted MCP server, Codex plugin descriptor, `config.toml`, `incident-triage` skill |
  57. ## The 12 Read-Only MCP Tools
  58. | Tool | What it reads |
  59. | --- | --- |
  60. | `list_sites` | Organisation status counts and every site's status, open incidents, and last check time (`site_id` source). |
  61. | `site_status` | One site's overall state, per-monitor uptime and valid-check coverage over 1–2160 hours, and latest regional results. |
  62. | `list_incidents` | Incidents newest first, optionally filtered by `site_id` and `state` (`open` or `resolved`). |
  63. | `incident_evidence` | Stored confirming and resolving probe observations (region, HTTP/TLS/DNS facts, error class, timings). |
  64. | `explain_incident` | Ranked likely cause category, confidence, supporting evidence, ruled-out causes, and what could not be checked. |
  65. | `what_changed` | Pre-incident and weekly site timeline: DNS, TLS certificate, redirect, SEO signals, domain expiry, and deploy markers. |
  66. | `first_day_findings` | Portfolio-wide ranked findings (expiring certificates/domains, redirects, SEO blocks, DNS issues, sites down). |
  67. | `monthly_report_summary` | Stored monthly client report summary (uptime, coverage, confirmed incidents, changes, expiring certificates). |
  68. | `security_overview` | Portfolio security and SEO integrity scan status, coverage, warnings, notices, and known software flaws (`vulnerable`). |
  69. | `site_security` | Latest scan details for one site: coverage, gaps, software components, and external findings with evidence. |
  70. | `list_maintenance` | Planned maintenance schedules (`upcoming`, `active`, `ended`) and active/next windows. |
  71. | `dns_changes` | Confirmed changes in watched NS, MX, SPF, DMARC, CAA, and TXT records. |
  72. ## Safety & Privacy
  73. - **Untrusted content fencing:** Text read from monitored websites or DNS records arrives inside `<<<UNTRUSTED ...>>>` blocks and is treated strictly as data, never as instructions.
  74. - **No fabricated measurements:** Missing checks always return `"data unavailable"`.
  75. - **Instant revocation:** Revoke any OAuth grant or API key anytime in Beamfar under **Settings -> Connected assistants** or **Integrations & API**.
  76. ## Trademarks & License
  77. Claude and Claude Code are trademarks of Anthropic, PBC. Gemini and Antigravity are trademarks of Google LLC. GitHub Copilot and Visual Studio Code are trademarks of Microsoft Corporation. Codex and ChatGPT are trademarks of OpenAI. Beamfar is an independent service and is not affiliated with or endorsed by any assistant vendor.
  78. MIT License — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.