Package Exports
- @uselamina/mcp
- @uselamina/mcp/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@uselamina/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@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 for programmatic Node.js/TypeScript integration.
Hosted OAuth MCP
For clients that support hosted remote MCP servers, prefer the Lamina hosted endpoint:
https://app.uselamina.com/mcp/agentUse the hosted install page for copyable endpoint values, OAuth metadata, and client setup patterns:
https://app.uselamina.com/mcp/installThe 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:
Run Locally
Without installing globally:
npx -y @uselamina/mcpOr install globally:
npm install -g @uselamina/mcp
lamina-mcpAvailable 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):
- Explicit CLI args when started through
lamina mcp serve LAMINA_API_KEYenvironment variable- Saved CLI login in
~/.lamina/config.json