Skip to documentation
Beacon Docs
AI connections (MCP)

Connect through MCP

Connect a compatible AI client to Beacon through Model Context Protocol.

Open Markdown

Model Context Protocol (MCP) lets a compatible AI client use Beacon tools for a signed-in user.

Use this hosted endpoint:

https://postwithbeacon.com/mcp

Use the exact address, including /mcp. Do not add an agent key to the MCP configuration.

Hosted MCP is available on every active Beacon plan, including Free. Your plan's post limits and AI credits still apply. Publishing to X through MCP requires Starter or a higher plan.

Codex

codex mcp add beacon --url https://postwithbeacon.com/mcp
codex mcp login beacon

Claude Code

claude mcp add --transport http --scope user beacon https://postwithbeacon.com/mcp

Use a Beacon tool to start browser sign-in.

OpenCode

opencode mcp add beacon --url https://postwithbeacon.com/mcp
opencode mcp auth beacon

Cursor

Add this server to .cursor/mcp.json:

{
  "mcpServers": {
    "beacon": {
      "url": "https://postwithbeacon.com/mcp"
    }
  }
}

Use a Beacon tool to start browser sign-in.

Complete browser sign-in

  1. Choose the Beacon account.
  2. Choose the workspace.
  3. Review the requested permissions.
  4. Approve the connection.
  5. Return to the AI client.

Beacon does not provide a local MCP server that runs on your computer. Use the hosted address for every supported client.