@uselamina/mcp
v0.1.0
Published
MCP server for Lamina - give AI agents the power to generate images, video, and content via 5 high-level tools
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:
- https://docs.uselamina.ai/guides/mcp-oauth-install
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
Docs
- https://docs.uselamina.ai/guides/agent-integration-patterns
- https://docs.uselamina.ai/guides/agent-recipes
