Cursor integration

Pro or Creator required. Give Cursor access to your Majico brand guidelines, design tokens, logo, color palettes, and Pulse/X analytics via the Majico MCP server.

Live docs: https://docs.majico.xyz/cursor/

What you need

Pro or Creator — MCP API access is gated to paid tiers.
Project ID — UUID from Account → Integrations or your guidelines URL.
Project API key — Shown on Integrations for eligible projects.
MCP config — Stdio (local Cursor) or HTTP (https://api.majico.xyz/mcp).

Setup (stdio — local Cursor)


{
  "mcpServers": {
    "majico": {
      "command": "npx",
      "args": ["-y", "user-majico-mcp@0.5.0"],
      "env": {
        "MAJICO_API_URL": "https://api.majico.xyz",
        "MAJICO_PROJECT_ID": "<your-project-uuid>",
        "MAJICO_API_KEY": "<your-project-api-key>"
      }
    }
  }
}

Or use Add to Cursor on Account → Integrations when enabled.

Bootstrap a project (agents)

Call MCP tool bootstrap_project with { "name": "my portal" } (requires MAJICO_AGENT_API_SECRET on the server and in MCP env). Returns:

projectId, projectApiKey
browserLogoUrl — /flow/logo?project=…&cursor=1
browserPaletteUrl — /guidelines/{id}?cursor=1
browserPulseUrl — /canvas?project=…&pulse=1&cursor=1

Open these in Cursor Glass for browser handoff after the user saves a choice.

MCP tools (v0.5)

Tool	Description
`get_guidelines`	Full brand markdown + LLM prompt
`get_design_tokens`	Palette and fonts
`get_logo_svg`	Selected logo SVG
`list_logo_candidates` / `select_logo`	Logo picking (list before select)
`list_palette_options` / `select_palette`	Color schemes (list before select)
`get_pulse_status`	Pulse/X link status
`list_pulse_posts`	Top posts for summaries
`generate_tweet_drafts` / `select_tweet_draft`	Tweet variants (user must pick)
`get_cursor_handoff` / `ack_cursor_handoff`	Browser → chat handoff
`get_studio_canvas`	Board snapshot
`get_design_md`	DESIGN.md for your repo

Interactive decisions

Pattern: list_* → user chooses → select_* → optional get_cursor_handoff → apply in repo → ack_cursor_handoff.

Agents must not auto-pick subjective brand choices (palette, logo, tweet draft) when multiple options exist.

Decision	List	Select
Color palette	`list_palette_options`	`select_palette`
Logo	`list_logo_candidates`	`select_logo`
Tweet draft	`generate_tweet_drafts`	`select_tweet_draft`

Browser handoff

User works in Glass (browserLogoUrl, browserPaletteUrl, or browserPulseUrl).
Page POSTs /api/projects/{id}/cursor-handoff with event e.g. palette_selected.
In chat: get_cursor_handoff → run chatPrompt → ack_cursor_handoff.

Next: Pulse on canvas · Notion, LinkedIn, X, Figma