lamina-mcp

# `@uselamina/mcp` MCP (Model Context Protocol) server for the Lamina public `/v1` API. Lamina is an agentic creative API for generating videos, movies, and images for products, brands, social, and ads. The MCP server lets Claude, Cursor, and other MCP-compatible agents create brand-aware creative assets directly -- no custom code needed. The agent sees five high-level tools, while the full lower-level API remains available over REST for developer integrations. **Use the MCP server when:** you want an AI agent (Claude, Cursor, Windsurf, etc.) to autonomously create images, videos, and text through Lamina without writing integration code. See also: [`@uselamina/sdk`](https://www.npmjs.com/package/@uselamina/sdk) for programmatic Node.js/TypeScript integration. ## Hosted OAuth MCP For clients that support hosted remote MCP servers, prefer the Lamina hosted endpoint: ```text https://app.uselamina.com/mcp/agent ``` Use the hosted install page for copyable endpoint values, OAuth metadata, and client setup patterns: ```text https://app.uselamina.com/mcp/install ``` The hosted endpoint uses OAuth and workspace-scoped bearer tokens, so tool schemas do not require an `apiKey` argument. The local stdio package below remains available for clients that spawn MCP servers locally. For client-specific install instructions covering ChatGPT, Codex, VS Code, Claude, Cursor, Windsurf, Continue, Cline, Zed, Goose, and Gemini CLI, see: - https://docs.uselamina.ai/guides/mcp-oauth-install ## Run Locally Without installing globally: ```bash npx -y @uselamina/mcp ``` Or install globally: ```bash npm install -g @uselamina/mcp lamina-mcp ``` ## Available tools | Tool | What it does | |------|-------------| | `lamina_create` | Natural-language brief to brand-aware content run | | `lamina_status` | Check a run, or wait for final generated assets | | `lamina_discover` | Discover what Lamina can make for a creative goal | | `lamina_brand` | Load brand memory, guidance, and winning patterns | | `lamina_batch` | Queue up to 10 related content creations | Lower-level capabilities such as app inspection, direct app runs, publishing, assets, templates, usage, and webhooks remain available through the public `/v1` REST API. ## Credentials The server reads credentials from (in order): 1. Explicit CLI args when started through `lamina mcp serve` 2. `LAMINA_API_KEY` environment variable 3. Saved CLI login in `~/.lamina/config.json` ## Docs - https://docs.uselamina.ai/guides/agent-integration-patterns - https://docs.uselamina.ai/guides/agent-recipes