Skip to main content
Beacon Cloud MCP lets your coding agent create a lens, upload versions, release one, and choose who can find it. Deleting a lens is only possible in the dashboard.

​
Before you start

  • Connect Beacon Cloud MCP with beacon mcp connect, or add https://mcp.beacon.sh to your client by hand. See Beacon Cloud MCP.
  • Allow write access. When your client signs in, the Beacon approval page offers a checkbox to also let it create and publish lenses. Tick it, then select Allow read and write access. Read-only connections cannot see the lens tools that change anything.
  • Give the agent a shell. The HTML file is uploaded with an HTTP request such as curl, never pasted into a tool call.
Access tokens created with beacon mcp token create are always read-only. To publish with a token instead of browser sign-in, create one with Read + publish lenses access on the MCP Access page.

​
Lens tools

​
Publish a new lens

Ask your agent to build and publish a lens, for example:
The agent then:
  1. Writes the HTML file, following the file rules.
  2. Creates the lens with beacon_lenses_create. It is private unless you ask otherwise.
  3. Calls beacon_lenses_prepare_upload with a version such as 1.0.0 and gets an upload URL.
  4. Uploads the file to that URL:
    The response carries an artifactId.
  5. Calls beacon_lenses_complete_upload with that artifactId.
  6. Releases the version with beacon_lenses_release_version once you approve, and gives you the lens page link, https://beacon.sh/lenses/<key>.
Upload URLs expire after 15 minutes and work once. If an upload fails, the agent can prepare the same version again.

​
Update an existing lens

Ask the agent to change the lens. It uploads the new file as a new version, such as 1.0.1, completes it, and releases it when you say so. Versions are immutable, so a version number cannot be reused. Uploading alone changes nothing for anyone using the lens. Only a release does.

​
Roll back

Ask the agent to release an earlier version:

​
Change details or visibility

Ask the agent to rename the lens, change its description or icon, or make it public or private. It calls beacon_lenses_update. The key cannot change.

Beacon Cloud MCP

Connect your agent and see every tool.

Managing lenses

Versions, releases and visibility.