Studio Ninja MCP server Let your AI agent run the Studio Ninja admin.

ToolWhat it doesAccess

• list_leads Leads with job type, date and last contact. read

  Returns open leads with client, job type, shoot date, source and days since last contact.

  MCP callstudio_ninja_read → list_leads

  REST endpointGET https://cotlet.dev/api/v1/studio-ninja/leads

  Parameters

  Parameters: list_leads

  Name	Type	Description
  no_reply_days integer	integer	Only leads with no contact in this many days.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "leads": [
      {
        "lead_id": "L-6610",
        "client": "Hannah & Liam Fletcher",
        "job_type": "Wedding",
        "date": "2027-03-20",
        "source": "Contact form",
        "days_since_contact": 6
      }
    ],
    "page": 1
  }

• add_lead Adds a lead from an enquiry. write

  Creates the client and lead with job type and date. Reaches no one, so it runs at once.

  MCP callstudio_ninja_write → add_lead

  REST endpointPOST https://cotlet.dev/api/v1/studio-ninja/leads

  Parameters

  Parameters: add_lead

  Name	Type	Description
  name string required	string	Client name.
  email string	string	Email.
  job_type string required	string	Job type as in your settings.
  date string	string	ISO shoot date.
  note string	string	What they wrote.

  Example input

  {
    "name": "Jane Doe",
    "job_type": "job type"
  }

  Example response

  {
    "lead_id": "L-6634",
    "client": "Priya Raman",
    "job_type": "Newborn",
    "date": "2026-12-04"
  }

• book_job Turns a lead into a booked job with its workflow. write

  Converts the lead to a job and applies the job type's workflow. Workflow emails that go to the client follow your workflow settings, so check them first. Reaches no one by itself, so it runs at once.

  MCP callstudio_ninja_write → book_job

  REST endpointPOST https://cotlet.dev/api/v1/studio-ninja/leads/{lead_id}/jobs

  Parameters

  Parameters: book_job

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.

  Example input

  {
    "lead_id": "L-6610"
  }

  Example response

  {
    "job_id": "J-3318",
    "client": "Hannah & Liam Fletcher",
    "job_type": "Wedding",
    "date": "2027-03-20",
    "status": "Booked"
  }

• list_jobs Booked jobs by date, with the next workflow task. read

  Returns jobs with client, date, job type, amount owing and the next open workflow task.

  MCP callstudio_ninja_read → list_jobs

  REST endpointGET https://cotlet.dev/api/v1/studio-ninja/jobs

  Parameters

  Parameters: list_jobs

  Name	Type	Description
  date_from string	string	ISO date.
  date_to string	string	ISO date.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "jobs": [
      {
        "job_id": "J-3290",
        "client": "Mitchell Doyle",
        "job_type": "Corporate headshots",
        "date": "2026-11-14",
        "owing": "0.00",
        "next_task": "Send gallery"
      }
    ],
    "page": 1
  }

• complete_task Marks a workflow task done on a job. write

  Ticks the task in the job workflow. If the task sends an email to the client, it waits for your OK.

  MCP callstudio_ninja_write → complete_task

  REST endpointPOST https://cotlet.dev/api/v1/studio-ninja/jobs/{job_id}/task/complete

  Parameters

  Parameters: complete_task

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.
  task string required	string	Task name.

  Example input

  {
    "job_id": "job_8c41d2",
    "task": "task"
  }

  Example response

  {
    "job_id": "J-3290",
    "task": "Send gallery",
    "status": "Done"
  }

ToolWhat it doesAccess

• list_clients Clients, searchable by name or email. read

  Returns clients with ID, contact details and their jobs.

  MCP callstudio_ninja_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/studio-ninja/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name or email.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "CL-5521",
        "name": "Priya Raman",
        "email": "priya@example.com",
        "jobs": 1
      }
    ],
    "page": 1
  }

ToolWhat it doesAccess

• send_contract Sends a contract from your templates for signing. writeasks first

  Fills the template with the job details and emails it for the client's signature. By default you confirm each call; you can switch that off for this tool.

  MCP callstudio_ninja_write → send_contract

  REST endpointPOST https://cotlet.dev/api/v1/studio-ninja/jobs/{job_id}/contracts

  Parameters

  Parameters: send_contract

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.
  template string required	string	Contract template name.

  Example input

  {
    "job_id": "job_8c41d2",
    "template": "template"
  }

  Example response

  {
    "contract_id": "CT-1187",
    "client": "Hannah & Liam Fletcher",
    "template": "Wedding contract",
    "status": "Sent"
  }

• send_invoice Creates and emails an invoice for a job. writeasks first

  Creates the invoice with your packages or line items and payment schedule, then emails it with the payment link. By default you confirm each call; you can switch that off for this tool.

  MCP callstudio_ninja_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/studio-ninja/jobs/{job_id}/invoices

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.
  items array required	array	Package or line items with price.
  schedule string	string	Payment schedule name.

  Example input

  {
    "job_id": "job_8c41d2",
    "items": "items"
  }

  Example response

  {
    "invoice_id": "INV-2041",
    "client": "Hannah & Liam Fletcher",
    "total": "4,200.00",
    "status": "Sent"
  }

• list_overdue Overdue invoices and payments due soon, from the Payments page. read

  Returns overdue and upcoming payments with client, job, amount and due date.

  MCP callstudio_ninja_read → list_overdue

  REST endpointGET https://cotlet.dev/api/v1/studio-ninja/overdues

  Parameters

  Parameters: list_overdue

  Name	Type	Description
  include_upcoming_days integer	integer	Also payments due in this many days.

  Example response

  {
    "payments": [
      {
        "client": "Mitchell Doyle",
        "job": "Corporate headshots",
        "amount": "650.00",
        "due": "2026-10-30",
        "status": "Overdue"
      }
    ]
  }