Skip to main content
Glama
user-majico-mcp

user-majico-mcp

Official
by majico-xyz

@majico/mcp

MCP server for Majico.xyz: read (and limited write) tools so coding agents can pull brand guidelines, design tokens, studio canvas, and export manifests.

Formerly published as user-majico-mcp — use @majico/mcp going forward (same pattern as @majico/sdk).

Requirements: Majico account with tokens. Cursor humans connect via OAuth (no API key in mcp.json). API keys are for automation/stdio only.

Install

npx -y @majico/mcp@0.8.3

Related MCP server: ds-mcp

Environment variables (v0.2+)

Set once in MCP config — tools do not require projectId / apiKey on every call:

Variable

Description

MAJICO_API_URL

API base (default http://localhost:3000; production https://api.majico.xyz)

MAJICO_PROJECT_ID

Project UUID

MAJICO_API_KEY

Project API key

Per-call overrides in tool arguments still work.

Tools

Tool

Description

get_brand_profile

Archetypes, niche intent

get_design_tokens

Palette and fonts

get_logo_svg

Selected logo SVG

get_guidelines

Markdown + LLM prompt

get_design_md

DESIGN.md markdown

get_studio_canvas

Studio canvas snapshot

get_export_manifest

Export file list

download_export_zip

Full BRAND.md / DESIGN.md / tokens ZIP (base64 in MCP response)

submit_brief

Submit product brief + enqueue niche research

update_studio_html_frame

Patch one htmlFrame (requires elementId, html)

generate_asset

Enqueue harness jobs (landing-page, investor-pack, investor-one-pager, investor-data-room, …)

get_asset_status

Poll harness job status

Cursor agent example: generate_asset for investor pack

After brand chain, palette, GTM, team, and traction are ready:

{
  "tool": "generate_asset",
  "arguments": {
    "skillId": "investor-pack",
    "params": {
      "team": {
        "members": [
          { "name": "Alex Kim", "role": "CEO", "bio": "ex-Stripe PM" }
        ]
      },
      "traction": {
        "metrics": [{ "label": "Waitlist", "value": "1,200" }]
      },
      "includeSlides": ["financials"]
    }
  }
}

Poll with get_asset_status({ jobId }). Preflight failures return HTTP 422 with code: "investor_pack_preflight_blocked" and a blocked reason (brand, gtm, team, traction, …).

Phase 2: one-pager and data room (after deck exists on canvas)

{
  "tool": "generate_asset",
  "arguments": {
    "skillId": "investor-one-pager"
  }
}
{
  "tool": "generate_asset",
  "arguments": {
    "skillId": "investor-data-room"
  }
}

Both require a harness-investor-pack element on the Studio canvas (generate investor-pack first). Without a deck, jobs return a stub with canvasUrl pointing to finish the deck.

Cursor .cursor/mcp.json (OAuth — preferred)

{
  "mcpServers": {
    "majico": {
      "url": "https://api.majico.xyz/mcp"
    }
  }
}

Complete Connect in Cursor Settings → MCP. Use list_projects and pass projectId on tool calls to switch scope.

Cursor .cursor/mcp.json (stdio — automation / local)

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

HTTP MCP (hosted)

OAuth (Cursor humans): https://api.majico.xyz/mcp — Connect in Cursor; no headers in mcp.json.

API key (automation only):

Authorization: Bearer <project_api_key>
X-Majico-Project-Id: <uuid>

Development

cd packages/user-majico-mcp
npm install
npm run build
npm test

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes your design system components and tokens to AI agents, preventing duplicate component creation and hardcoded token values.
      4 npm
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A read-only MCP server that provides AI coding agents with a queryable contract for design system tokens, components, patterns, and anti-patterns.
      24 npm
      1
      Apache 2.0