Skip to content

Beacon for AI assistants

Create with your AI assistant. Publish with Beacon.

Use your AI assistant to create, adapt, and schedule social media posts from your Beacon workspace. You control what goes live. Developers can connect through Model Context Protocol (MCP).

Hosted Beacon MCP
https://postwithbeacon.com/mcp
  • Browser sign-in selects the account and workspace.
  • Permissions stay visible and revocable.
  • Publish-now requests require a separate Beacon approval.

From your AI conversation to a ready-to-publish post.

  1. 01

    Connect

    Choose one Beacon workspace and review access.

  2. 02

    Check

    Check the content against each platform's requirements.

  3. 03

    Prepare

    Create a draft or schedule it in your workspace.

  4. 04

    Approve

    Review and approve the post before it publishes immediately.

Connect the AI assistant you already use.

Beacon hosts the server. Do not add an agent key to an MCP configuration. Use browser sign-in and grant only the permissions the client needs.

Codex

Add the hosted server, then complete Beacon sign-in from Codex.

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

Claude Code

Add Beacon as a user-level HTTP server, then start sign-in with a Beacon tool.

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

ChatGPT

Use Beacon as a remote MCP connection when your ChatGPT client supports remote MCP and browser sign-in.

Open the MCP settings in your client. Add the hosted Beacon address, then follow the browser sign-in flow.

Cursor

Add the hosted Beacon server to .cursor/mcp.json, then start browser sign-in with a Beacon tool.

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

OpenCode

Add the hosted server and authorize the Beacon connection from OpenCode.

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

Help your AI assistant work with Beacon.

Install the portable Beacon skill when your agent supports skill files. It explains how to prepare content, check it, ask for approval, and handle posts that need attention.

Install the Beacon skill

Ready-to-run workflows

Copy a workflow into your assistant or automation tool.

Use these starter recipes with Claude Code, Codex, Cursor, the TypeScript SDK, or n8n and Zapier HTTP steps.

01 · MCP PROMPT

Turn release notes into multi-channel drafts

Ask your connected AI assistant to check platform limits first and schedule drafts across your channels.

List my connected Beacon channels, check a post announcing our latest release for X, LinkedIn, and Bluesky with beacon_check_post, then schedule it for tomorrow at 09:00 UTC.

02 · TYPESCRIPT SDK

Schedule from your own backend or CI

Validate against destination rules and schedule idempotently with @beacon/sdk.

import { createBeaconClient } from "@beacon/sdk";

const beacon = createBeaconClient({
  baseUrl: "https://postwithbeacon.com",
  publicKey: process.env.BEACON_PUBLIC_KEY!,
});

03 · PUBLIC API (N8N / ZAPIER)

Automate without manual approval stops

Workspace keys (bcn_) call /public/v1/posts directly with an Idempotency-Key header.

POST https://postwithbeacon.com/public/v1/posts
Authorization: Bearer bcn_your_workspace_key
Idempotency-Key: release-2026-10-22