@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: figma-mcp-write-server

Environment variables (v0.2+)

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

Per-call overrides in tool arguments still work.

Tools

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