beaconed-mcp MCP Server

MCP server exposing the Beaconed v1 API to Claude Desktop, Cursor, and any MCP-compatible client. Ask Claude to list your products, queue optimizations, approve AI-generated copy, and manage…

Local serverstdioMIT

What is the beaconed-mcp Server?

beaconed-mcp is an MCP project maintained in the beaconed/beaconed-mcp repository. The maintainer describes its purpose as “MCP server exposing the Beaconed v1 API to Claude Desktop, Cursor, and any MCP-compatible client. Ask Claude to list your products, queue optimizations, approve AI-generated…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using beaconed-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares BEACONED_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
beaconed_products_list	list products with filters for status, score, grade, and title search
beaconed_products_get	full product detail including images, score history, and latest optimization
beaconed_products_scores	score history for a specific product
beaconed_products_optimizations	list optimizations scoped to a product
beaconed_optimizations_list	list all AI-generated optimizations across all products
beaconed_optimizations_get	full optimization detail (original vs. suggested content)
beaconed_scores_list	readiness scores across all products
beaconed_scores_latest	latest score per product
beaconed_settings_get	account optimization settings (brand voice, keywords, auto-push config)
beaconed_webhooks_list	list webhook subscriptions
beaconed_webhooks_get	webhook detail including last error info
beaconed_webhooks_events	global catalog of all available webhook event types
beaconed_products_create	create a product from external (non-Shopify) data
beaconed_products_update	update product fields (partial update)
beaconed_products_sync	refresh all products in the selected product’s shop from Shopify (rate limit: 10 requests/min)
beaconed_products_optimize	queue AI optimization for one or more product fields (rate limit: 10 requests/min)
beaconed_products_calculate_score	recalculate readiness score for a product (rate limit: 10 requests/min)
beaconed_optimizations_approve	approve a pending optimization; can publish live content when auto-push is enabled (rate limit: 10 requests/min)
beaconed_optimizations_reject	reject a pending optimization with an optional reason
beaconed_optimizations_apply	request application of an approved optimization to the live product (DESTRUCTIVE, rate limit: 10 requests/min)
beaconed_optimizations_revert	request reversion of an applied optimization to original content (DESTRUCTIVE, rate limit: 10 requests/min)
beaconed_webhooks_create	create a webhook subscription (signing secret returned once only)
beaconed_webhooks_update	update a webhook URL, events, or status
beaconed_webhooks_delete	permanently remove a webhook subscription (DESTRUCTIVE)
beaconed_webhooks_test	send a test event to verify delivery
beaconed_bulk_optimize	queue AI optimization for multiple products in one request (rate limit: 10 requests/min)

How to install the beaconed-mcp Server

{
  "mcpServers": {
    "beaconed": {
      "command": "beaconed-mcp",
      "env": {
        "BEACONED_API_KEY": "YOUR_BEACONED_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.