beacon mcp

Expose local Beacon activity to MCP clients

Command Overview

The beacon mcp command group exposes local Beacon endpoint activity to MCP clients so an assistant can search, summarize, and retrieve compact event records from the local runtime.jsonl log.

Command syntax

beacon mcp [command]

The server reads the same local runtime log used by the dashboard. It supports stdio for desktop MCP clients and loopback HTTP JSON-RPC for local tools that connect to a running server.

Commands

beacon mcp serve

Run the local Beacon MCP server.

beacon mcp doctor

Validate local Beacon MCP setup and print client configuration.

MCP tools

Beacon exposes these MCP tools:

Tool	Description
search_activity	Search local Beacon activity logs and return compact event summaries.
summarize_activity	Summarize local Beacon activity over a time window and optional filters.
get_activity_event	Fetch one compact event by an ID returned from search_activity.
list_activity_filters	List common filter values found in local Beacon activity logs.

Search and summary tools accept filters such as since, until, limit, q, harness, model, action, severity, category, repository, session, file, command, mcp, approval, decision, policy, review, and wazuh_level.

Flags

Flag	Description
--user	Use per-user endpoint paths. Enabled by default
--system	Use system endpoint paths
--log-path PATH	Runtime JSONL log path
--transport stdio|http	MCP transport. Defaults to stdio
--addr ADDR	Loopback HTTP JSON-RPC listen address for --transport http. Defaults to 127.0.0.1:8766

beacon mcp only reads local Beacon runtime logs. It does not require a hosted Beacon account, and HTTP transport should remain bound to loopback.

Related

beacon mcp serve

Run the local Beacon MCP server.

beacon mcp doctor

Validate local Beacon MCP setup.

Connect Cursor and Claude Code

Install Beacon MCP in local assistant clients.

Dashboard

Inspect the same local activity log in a browser.

Endpoint event schema

Review the normalized JSONL fields behind MCP activity results.