Connect once, then ask your assistant to browse projects, organize canvases and subjects, upload image references, download assets, and run approved generation. For the smoothest onboarding, start with Claude Desktop or Claude on the web.
Claude Desktop & Web
Recommended setupThe simplest setup is Claude’s connector settings. Add Martini once, sign in, then ask Claude to work with your Martini projects.
Setup for other agents
Connect another supported MCP client.
Other MCP clients
Generally connectable as long as the client supports hosted MCP or Streamable HTTP.
Prompt ideas
Try asking your connected agent to turn early creative material into Martini project structure.
- Create a storyboard. “Turn this concept into a storyboard in Martini: create canvases, add shot nodes for each beat, draft prompts, and organize everything in sequence.”
- Break down a script. “Read this script and turn it into Martini structure: characters as subject nodes, locations as canvases, and reusable variables for common settings, moods, and character descriptions.”
- Build a character library. “Create subject nodes for the recurring characters in this treatment, add concise visual descriptions, and group related references so I can use them across canvases.”
- Draft a generation pass. “For this sequence, draft model choices, prompts, subject bindings, and generation counts for each shot so I can review them before anything is submitted.”
- Review and organize a project. “Audit this project for missing subjects, inconsistent names, duplicate references, and unclear shot organization, then suggest a cleaner board layout.”
What you can do
Martini’s MCP tools cover the main assistant workflows inside a project:
- Browse projects. List your projects, canvases, subjects, and assets, and pull detailed metadata when you need it.
- Organize the canvas. Create canvases, create reusable subjects (characters, props, animals), and add or move nodes on the canvas.
- Upload images. Send up to 50 images at a time directly into a canvas. Audio and video uploads still happen in the Martini app for now.
- Run approved generation. In the full connector, your assistant can generate media for existing or newly planned shot nodes after you approve the model, prompt, count, and estimated olive cost.
Martini keeps the same account boundaries in MCP: assistants can only use projects, assets, credits, and generation actions your account can already access, and generation still requires approval.
Show tool inventory
The full profile includes generation tools. The core profile omits direct generation tools such as generate, create_node_and_generate, and create_nodes_and_generate.
| Tool | Description | Type |
|---|---|---|
List Projects get_projects | Search projects with optional query limits. | Read |
Create Project create_project | Create a new personal or team project. | Write |
Rename Project rename_project | Rename a writable project. | Write |
Prepare Support Request prepare_support_request | Prepare a redacted support request preview. | Read |
Submit Support Request submit_support_request | Submit a prepared support packet after explicit approval. | Write |
Get Board Overview get_board_overview | One-call orientation with canvases, subjects, collections, and canvas children. | Read |
List Board Assets get_board_assets | Summarized assets and canvas positions for a project. | Read |
Get Asset Detail get_asset | Full metadata for a single asset. | Read |
Get Asset Draft Settings get_asset_draft_settings | Generation configuration for one asset. | Read |
List Board Canvases get_board_canvases | Canvases, canvas bins, and text annotations. | Read |
List Board Subjects get_board_subjects | All subjects on a project. | Read |
Get Subject Detail get_subject | Full detail for a subject. | Read |
Get Canvas Children get_canvas_children | Direct canvas or bin children; collection cards stay spatial. | Read |
Get Subject Collection get_subject_collection | One collection with hydrated member subjects. | Read |
List Subject Collections get_subject_collections | Collections with member subject names and IDs. | Read |
View Collection Card view_subject_collection_card | Compact visual card, structured metadata, and readable card resource. | Read |
Create Subject create_subject | Create a reusable character, prop, or animal subject. | Write |
Create Subject Collection create_subject_collection | Group existing subjects into a collection. | Write |
Rename Subject Collection rename_subject_collection | Rename a subject collection. | Write |
Reorder Subjects in Collection reorder_subjects_in_collection | Reorder existing subjects without changing membership. | Write |
Add Subjects to Collection add_subjects_to_collection | Add existing subjects to a collection. | Write |
Remove Subjects from Collection remove_subjects_from_collection | Remove subjects; empty collections dissolve. | Write |
Reorder Variation Stack Members reorder_variation_stack_members | Reorder existing stack members without changing membership. | Write |
Get Canvas get_canvas | A single canvas with summaries and positions. | Read |
Create Canvas create_canvas | Create a new canvas in a project. | Write |
Create Node create_node | Create an empty draft node, with optional prompt and subject bindings. | Write |
Create Node and Generate create_node_and_generate | Create a planned shot node and run an approved generation for it. | Write |
Create Nodes and Generate (Batch) create_nodes_and_generate | Create multiple planned shot nodes and run approved generations for them. | Write |
Create Nodes (Batch) create_nodes | Create multiple draft nodes with server-owned placement. | Write |
Move Node move_node | Reposition a node on the canvas. | Write |
Check Storage Reachability check_storage_reachability | Preflight check that R2 storage is reachable for both uploads and downloads. | Read |
View Image Asset Inline view_asset | Inline an image asset (≤10MB) directly into the agent context for inspection. | Read |
Get Asset Download URL get_asset_download_url | Return a short-lived presigned URL the agent can use to save the asset to disk. | Read |
Initialize Asset Upload upload_asset_init | Begin uploading an image; returns a presigned URL. | Write |
Complete Asset Upload upload_asset_complete | Finalize an upload after bytes arrive in storage. | Write |
Initialize Batch Asset Upload upload_asset_init_batch | Begin uploading up to 50 images in one call. | Write |
Complete Batch Asset Upload upload_asset_complete_batch | Finalize a batch upload. | Write |
List Models list_models | Available generation models. | Read |
Get Model get_model | Pricing, inputs, and constraints for a model. | Read |
Get Job Status get_job_status | Status of a generation job. | Read |
List Project Jobs list_project_jobs | All generation jobs for a project. | Read |
Generate Asset generate | Generate media for an existing shot after model, prompt, count, and cost approval. | Write |
Safety & security
Billing guards
Any operation that deducts Olive Credits requires your explicit approval or confirmation before credits are spent. Martini still enforces your account permissions, credit balance, spend limits, provider limits, rate limits, and content rules.
Connector profiles
The full profile at https://www.martini.film/mcp includes approved image and video generation. The core profile at https://www.martini.film/mcp-core keeps the common project, board, canvas, subject, upload, download, review, and organization tools without direct generation tools.
What data is shared
Anything shared with your MCP client is made visible through tool-call requests and responses. Those tool calls may include project names, canvas structure, asset metadata and previews, subject details, prompts, model settings, job status, and short-lived storage URLs.
Policies
Use of the connector is governed by Martini’s Terms of Service and Privacy Policy. Generation jobs may also be subject to third-party model provider terms.
Troubleshooting
“Origin not allowed”
The connector validates the Origin header on browser-based requests. If you’re using a browser-based MCP client from a domain other than claude.ai or claude.com, email support@martini.film and we’ll add you to the allowlist.
Uploads or downloads fail with a network error
If you’re calling Martini from an environment with restricted egress (e.g. a sandbox), R2 may be blocked for both uploads (PUT) and downloads (GET). Run the check_storage_reachability tool first — it returns a probe URL and a remediation message you can follow.
Support
Questions, bug reports, and feature requests: support@martini.film. Partnership and integration inquiries: hello@martini.film.
More information is available on our support and security pages.