Documentation Index
Fetch the complete documentation index at: https://docs.asymptotelabs.ai/llms.txt
Use this file to discover all available pages before exploring further.
beacon mcp
Thebeacon 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.
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. |
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.