Koskamo

mcp-dir iClips MCP

An MCP server for iClips agency ERP that allows agents to read financial data (bank accounts, payables/receivables, invoices with taxes), manage jobs, pieces, tasks, checklists, and extract time logs per person and department. It supports filtering by client, supplier, category, and DRE indicators, with financial data being read-only.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

mcp-dir iClips MCP logo, by mcp-dirCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by mcp-dir
MCP endpoint (Streamable HTTP)
https://api.mcp.ai/p_iclips
Vendor documentation

What its tools do

30 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

30 of 30 have a description · 30 of 30 declare behavior hints · 0 of 27 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • List bank accounts and financial entries for an agency
  • Retrieve issued service invoices (NFS-e) with withheld taxes
  • Create jobs and update tasks or production checklists
  • Extract time logs pointed by person and piece within project hierarchy

Source and maintenance

Community listingRegistry 0.1.0
Maintenance checked

Protocol and capabilities

Server
mcp-ai 0.9.410
MCP protocol negotiated in check
2025-11-25
Tools
30 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

MCP.AI platform v0.9.410 | Adapters: iclips vunknown. When the user asks about the version (e.g. "qual a versão", "which version"), call the show_version tool. NEW MCPs/tools/integrations (capabilities not already in this toolkit) come from the official mcp.ai catalog: the `marketplace` tool (action=search) finds and runs them. You are not authenticated yet. Call the authenticate tool first — it will give the user a browser link to log in and copy a token. No other tools will work until authenticated.

Tools

30 advertised

iclips_list_accounts
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as agências iClips (chaves de API) ligadas a este install, com id, apelido e nome.

iclips_list_accounts input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
iclips_list_accounts annotations
{
  "title": "iclips_list_accounts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_financial_accounts
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as contas bancárias ativas da agência no iClips (id, nome, isDefault, banco, agência e número da conta). Use o id retornado como account_id ao filtrar iclips_financial_entries. Não tem filtro nem paginação: devolve sempre todas as contas ativas.

iclips_financial_accounts input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
iclips_financial_accounts annotations
{
  "title": "iclips_financial_accounts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_financial_entries_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber). Ações: - list: exige from e to (AAAA-MM-DD, no máximo 366 dias de intervalo). Filtre por type, account_id, category_id, dre_indicator, destination_id e job_id. Pagine com limit (padrão 50, máximo 200) e offset. - get: detalhe completo de um ou mais lançamentos por entry_ids (em lote, com erro reportado por id). date_field escolhe QUAL data o from/to filtra: entry (padrão) é o entryDate, que para "A Pagar" e "A Receber" é o VENCIMENTO da parcela; payment é o paymentDate, a data da baixa, então só traz o que já foi pago; competence é o competenceDate. Para saber o que vence no mês, use type="A Pagar" (ou "A Receber") com date_field=entry no intervalo do mês: cada parcela é um lançamento próprio. Devolve valor, impostos retidos (irrf e issrf), categoria com o indicador de DRE, conta bancária, nota fiscal vinculada, destinatário (cliente ou fornecedor) e o rateio por centro de custo. Não existe escrita no financeiro: o iClips expõe esse módulo apenas para leitura, por decisão dele. [Flattened action: list]

iclips_financial_entries_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "type": {
      "enum": [
        "Entrada",
        "Saída",
        "A Receber",
        "A Pagar"
      ],
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "job_id": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "entry_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "account_id": {
      "type": "number"
    },
    "date_field": {
      "enum": [
        "entry",
        "payment",
        "competence"
      ],
      "type": "string"
    },
    "category_id": {
      "type": "number"
    },
    "dre_indicator": {
      "enum": [
        "DESPESAS OPERACIONAIS",
        "DESPESAS OPERACIONAIS CUSTO VARIÁVEL",
        "DESPESAS OPERACIONAIS CUSTO FIXO",
        "DESPESAS NÃO OPERACIONAIS",
        "IMPOSTOS",
        "PARTICIPAÇÃO NOS LUCROS",
        "RECEITAS OPERACIONAIS",
        "RECEITAS NÃO OPERACIONAIS",
        "RECEITAS TOTAIS",
        "NENHUM",
        "OUTRO"
      ],
      "type": "string"
    },
    "destination_id": {
      "type": "number"
    }
  }
}
iclips_financial_entries_list annotations
{
  "title": "iclips_financial_entries_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_financial_entries_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber). Ações: - list: exige from e to (AAAA-MM-DD, no máximo 366 dias de intervalo). Filtre por type, account_id, category_id, dre_indicator, destination_id e job_id. Pagine com limit (padrão 50, máximo 200) e offset. - get: detalhe completo de um ou mais lançamentos por entry_ids (em lote, com erro reportado por id). date_field escolhe QUAL data o from/to filtra: entry (padrão) é o entryDate, que para "A Pagar" e "A Receber" é o VENCIMENTO da parcela; payment é o paymentDate, a data da baixa, então só traz o que já foi pago; competence é o competenceDate. Para saber o que vence no mês, use type="A Pagar" (ou "A Receber") com date_field=entry no intervalo do mês: cada parcela é um lançamento próprio. Devolve valor, impostos retidos (irrf e issrf), categoria com o indicador de DRE, conta bancária, nota fiscal vinculada, destinatário (cliente ou fornecedor) e o rateio por centro de custo. Não existe escrita no financeiro: o iClips expõe esse módulo apenas para leitura, por decisão dele. [Flattened action: get]

iclips_financial_entries_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "type": {
      "enum": [
        "Entrada",
        "Saída",
        "A Receber",
        "A Pagar"
      ],
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "job_id": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "entry_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "account_id": {
      "type": "number"
    },
    "date_field": {
      "enum": [
        "entry",
        "payment",
        "competence"
      ],
      "type": "string"
    },
    "category_id": {
      "type": "number"
    },
    "dre_indicator": {
      "enum": [
        "DESPESAS OPERACIONAIS",
        "DESPESAS OPERACIONAIS CUSTO VARIÁVEL",
        "DESPESAS OPERACIONAIS CUSTO FIXO",
        "DESPESAS NÃO OPERACIONAIS",
        "IMPOSTOS",
        "PARTICIPAÇÃO NOS LUCROS",
        "RECEITAS OPERACIONAIS",
        "RECEITAS NÃO OPERACIONAIS",
        "RECEITAS TOTAIS",
        "NENHUM",
        "OUTRO"
      ],
      "type": "string"
    },
    "destination_id": {
      "type": "number"
    }
  }
}
iclips_financial_entries_get annotations
{
  "title": "iclips_financial_entries_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_financial_invoices_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. Ações: - list: exige from e to (AAAA-MM-DD, no máximo 366 dias, filtrando pela data de emissão). Filtro opcional por status. Pagine com limit (padrão 50, máximo 200) e offset. - get: detalhe completo de uma ou mais notas por invoice_ids (em lote, com erro reportado por id). Devolve valor bruto e líquido, base de cálculo, alíquota e valor do ISS, retenções de PIS, COFINS, INSS, IR e CSLL, a discriminação do serviço, os dados do tomador e do emitente, os números do RPS e o motivo do cancelamento quando o status é cancelled. [Flattened action: list]

iclips_financial_invoices_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "status": {
      "enum": [
        "pending",
        "issued",
        "cancelled",
        "error"
      ],
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "invoice_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_financial_invoices_list annotations
{
  "title": "iclips_financial_invoices_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_financial_invoices_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips. Ações: - list: exige from e to (AAAA-MM-DD, no máximo 366 dias, filtrando pela data de emissão). Filtro opcional por status. Pagine com limit (padrão 50, máximo 200) e offset. - get: detalhe completo de uma ou mais notas por invoice_ids (em lote, com erro reportado por id). Devolve valor bruto e líquido, base de cálculo, alíquota e valor do ISS, retenções de PIS, COFINS, INSS, IR e CSLL, a discriminação do serviço, os dados do tomador e do emitente, os números do RPS e o motivo do cancelamento quando o status é cancelled. [Flattened action: get]

iclips_financial_invoices_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "status": {
      "enum": [
        "pending",
        "issued",
        "cancelled",
        "error"
      ],
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "invoice_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_financial_invoices_get annotations
{
  "title": "iclips_financial_invoices_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_jobs_write_create
Advertised by the server during the last successful anonymous check.

Cria ou atualiza um job (projeto) no iClips. Ações: - create: o data exige titulo (até 100 caracteres), status e exatamente um entre clienteId e grupoClienteId. Opcionais: entradaDate, aprovacaoDate, conclusaoDate (AAAA-MM-DD), prioridade (1=Baixa, 2=Média, 3=Alta), servico, campanha, descricao, briefing, verba, idVerba, idFeeMensal, funcionarioId, auxiliarId, modeloIds (int[]), pecaIds (int[]) e tarefasInput (lista de {titulo, descricao, inicioDate, fimDate, prioridade, ordemExibicao}). - update: exige job_id; o data exige titulo e status. modeloIds, pecaIds e tarefasInput são IGNORADOS aqui, use iclips_job_pieces_write e iclips_job_tasks_write para mexer nas peças e tarefas do job. Códigos de status: 1=Proposta Comercial, 2=Concorrência, 3=Risco, 5=Aguardando Aprovação, 6=Autorizado, 7=Finalizado, 8=Cancelado, 9=Aberto pelo Cliente, 10=Pré Produção, 11=Stand By. Devolve jobId, titulo, sigla, status, totalPecas e totalTarefas. [Flattened action: create] Bulk support: accepts job_ids for batched execution.

iclips_jobs_write_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_jobs_write_create annotations
{
  "title": "iclips_jobs_write_create",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_jobs_write_update
Advertised by the server during the last successful anonymous check.

Cria ou atualiza um job (projeto) no iClips. Ações: - create: o data exige titulo (até 100 caracteres), status e exatamente um entre clienteId e grupoClienteId. Opcionais: entradaDate, aprovacaoDate, conclusaoDate (AAAA-MM-DD), prioridade (1=Baixa, 2=Média, 3=Alta), servico, campanha, descricao, briefing, verba, idVerba, idFeeMensal, funcionarioId, auxiliarId, modeloIds (int[]), pecaIds (int[]) e tarefasInput (lista de {titulo, descricao, inicioDate, fimDate, prioridade, ordemExibicao}). - update: exige job_id; o data exige titulo e status. modeloIds, pecaIds e tarefasInput são IGNORADOS aqui, use iclips_job_pieces_write e iclips_job_tasks_write para mexer nas peças e tarefas do job. Códigos de status: 1=Proposta Comercial, 2=Concorrência, 3=Risco, 5=Aguardando Aprovação, 6=Autorizado, 7=Finalizado, 8=Cancelado, 9=Aberto pelo Cliente, 10=Pré Produção, 11=Stand By. Devolve jobId, titulo, sigla, status, totalPecas e totalTarefas. [Flattened action: update] Bulk support: accepts job_ids for batched execution.

iclips_jobs_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_jobs_write_update annotations
{
  "title": "iclips_jobs_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_jobs_delete
Advertised by the server during the last successful anonymous check.
Advertised destructive

Exclui jobs (projetos) do iClips. É destrutivo e não tem desfazer pela API. Aceita job_ids para remover vários de uma vez, em lote, com erro reportado por id.

iclips_jobs_delete input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "job_ids"
  ],
  "properties": {
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_jobs_delete annotations
{
  "title": "iclips_jobs_delete",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}
iclips_job_pieces_write_add
Advertised by the server during the last successful anonymous check.

Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele. Ações: - add: exige job_id e data.pecaId (id da peça no catálogo, veja iclips_pieces). Opcionais no data: titulo, descricao e prioridade (1, 2 ou 3). Devolve jobPecaId, que é o id da peça DENTRO do job e o que se usa no update. - update: exige job_id e job_piece_id (o jobPecaId, NÃO o pecaId do catálogo). Todo campo do data é opcional, mande só o que muda: titulo, descricao, formato, servico e prioridade. [Flattened action: add] Bulk support: accepts job_ids, job_piece_ids for batched execution.

iclips_job_pieces_write_add input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "job_id",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "job_piece_id": {
      "type": "number"
    },
    "job_piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_job_pieces_write_add annotations
{
  "title": "iclips_job_pieces_write_add",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_job_pieces_write_update
Advertised by the server during the last successful anonymous check.

Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele. Ações: - add: exige job_id e data.pecaId (id da peça no catálogo, veja iclips_pieces). Opcionais no data: titulo, descricao e prioridade (1, 2 ou 3). Devolve jobPecaId, que é o id da peça DENTRO do job e o que se usa no update. - update: exige job_id e job_piece_id (o jobPecaId, NÃO o pecaId do catálogo). Todo campo do data é opcional, mande só o que muda: titulo, descricao, formato, servico e prioridade. [Flattened action: update] Bulk support: accepts job_ids, job_piece_ids for batched execution.

iclips_job_pieces_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "job_id",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "job_piece_id": {
      "type": "number"
    },
    "job_piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_job_pieces_write_update annotations
{
  "title": "iclips_job_pieces_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_job_tasks_write_create
Advertised by the server during the last successful anonymous check.

Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. Ações: - create: exige job_id e data.titulo (até 150 caracteres). Opcionais no data: descricao, inicioDate, fimDate (AAAA-MM-DD), prioridade (1, 2 ou 3) e ordemExibicao. Devolve idTarefaJob, que é o id usado no update. - update: exige job_id e task_id (o idTarefaJob). Todo campo do data é opcional, mande só o que muda. Os nomes de campo da ESCRITA (titulo, inicioDate, fimDate) são diferentes dos que o iclips_projects_extract devolve na LEITURA (tituloAtividade, inicioPlanejado, fimPlanejado). [Flattened action: create] Bulk support: accepts job_ids, task_ids for batched execution.

iclips_job_tasks_write_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "job_id",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "task_id": {
      "type": "number"
    },
    "task_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_job_tasks_write_create annotations
{
  "title": "iclips_job_tasks_write_create",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_job_tasks_write_update
Advertised by the server during the last successful anonymous check.

Cria ou atualiza uma tarefa manual dentro de um job existente no iClips. Ações: - create: exige job_id e data.titulo (até 150 caracteres). Opcionais no data: descricao, inicioDate, fimDate (AAAA-MM-DD), prioridade (1, 2 ou 3) e ordemExibicao. Devolve idTarefaJob, que é o id usado no update. - update: exige job_id e task_id (o idTarefaJob). Todo campo do data é opcional, mande só o que muda. Os nomes de campo da ESCRITA (titulo, inicioDate, fimDate) são diferentes dos que o iclips_projects_extract devolve na LEITURA (tituloAtividade, inicioPlanejado, fimPlanejado). [Flattened action: update] Bulk support: accepts job_ids, task_ids for batched execution.

iclips_job_tasks_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "job_id",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "job_id": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "job_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "task_id": {
      "type": "number"
    },
    "task_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_job_tasks_write_update annotations
{
  "title": "iclips_job_tasks_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_pieces_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê o catálogo de peças da agência no iClips. Ações: - list: busca textual opcional por q, mais filtros por categoria, status e basedOnTemplateId. Pagine com page e pageSize (padrão 20). - get: detalhe de uma ou mais peças por piece_ids, incluindo o workflowJson e o checklistJson completos (em lote, com erro reportado por id). [Flattened action: list]

iclips_pieces_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "status": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "pageSize": {
      "type": "number"
    },
    "categoria": {
      "type": "string"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "basedOnTemplateId": {
      "type": "string"
    }
  }
}
iclips_pieces_list annotations
{
  "title": "iclips_pieces_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_pieces_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê o catálogo de peças da agência no iClips. Ações: - list: busca textual opcional por q, mais filtros por categoria, status e basedOnTemplateId. Pagine com page e pageSize (padrão 20). - get: detalhe de uma ou mais peças por piece_ids, incluindo o workflowJson e o checklistJson completos (em lote, com erro reportado por id). [Flattened action: get]

iclips_pieces_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "status": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "pageSize": {
      "type": "number"
    },
    "categoria": {
      "type": "string"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "basedOnTemplateId": {
      "type": "string"
    }
  }
}
iclips_pieces_get annotations
{
  "title": "iclips_pieces_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_pieces_write_create
Advertised by the server during the last successful anonymous check.

Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. Ações: - create: o data exige name (até 255 caracteres) e exatamente UM entre basedOnTemplateId e workflowJson. Opcionais: description, valorDecimal, valorSindraproCriacaoDecimal, valorSindraproAdaptacaoDecimal, valorSindraproFinalizacaoDecimal, valorTotalDecimal, exibirBool, digitalBool, isFlexible, briefingCliente, pecaCliente, idSindicato, tempoMedio, instrucao, checklistJson e categoriaIds (int[]). Devolve o id da peça nova em data. - update: exige piece_id; o data exige name, workflowJson e checklistJson (este endpoint SUBSTITUI os dois, então leia a peça antes com iclips_pieces action=get). - checklist: exige piece_id e data {itemId, done}. Marca um item do checklist de produção como concluído (true) ou pendente (false). Use iclips_workflow_templates para descobrir o basedOnTemplateId e iclips_piece_categories para os categoriaIds. [Flattened action: create] Bulk support: accepts piece_ids for batched execution.

iclips_pieces_write_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "piece_id": {
      "type": "number"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_pieces_write_create annotations
{
  "title": "iclips_pieces_write_create",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_pieces_write_update
Advertised by the server during the last successful anonymous check.

Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. Ações: - create: o data exige name (até 255 caracteres) e exatamente UM entre basedOnTemplateId e workflowJson. Opcionais: description, valorDecimal, valorSindraproCriacaoDecimal, valorSindraproAdaptacaoDecimal, valorSindraproFinalizacaoDecimal, valorTotalDecimal, exibirBool, digitalBool, isFlexible, briefingCliente, pecaCliente, idSindicato, tempoMedio, instrucao, checklistJson e categoriaIds (int[]). Devolve o id da peça nova em data. - update: exige piece_id; o data exige name, workflowJson e checklistJson (este endpoint SUBSTITUI os dois, então leia a peça antes com iclips_pieces action=get). - checklist: exige piece_id e data {itemId, done}. Marca um item do checklist de produção como concluído (true) ou pendente (false). Use iclips_workflow_templates para descobrir o basedOnTemplateId e iclips_piece_categories para os categoriaIds. [Flattened action: update] Bulk support: accepts piece_ids for batched execution.

iclips_pieces_write_update input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "piece_id": {
      "type": "number"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_pieces_write_update annotations
{
  "title": "iclips_pieces_write_update",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_pieces_write_checklist
Advertised by the server during the last successful anonymous check.

Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist. Ações: - create: o data exige name (até 255 caracteres) e exatamente UM entre basedOnTemplateId e workflowJson. Opcionais: description, valorDecimal, valorSindraproCriacaoDecimal, valorSindraproAdaptacaoDecimal, valorSindraproFinalizacaoDecimal, valorTotalDecimal, exibirBool, digitalBool, isFlexible, briefingCliente, pecaCliente, idSindicato, tempoMedio, instrucao, checklistJson e categoriaIds (int[]). Devolve o id da peça nova em data. - update: exige piece_id; o data exige name, workflowJson e checklistJson (este endpoint SUBSTITUI os dois, então leia a peça antes com iclips_pieces action=get). - checklist: exige piece_id e data {itemId, done}. Marca um item do checklist de produção como concluído (true) ou pendente (false). Use iclips_workflow_templates para descobrir o basedOnTemplateId e iclips_piece_categories para os categoriaIds. [Flattened action: checklist] Bulk support: accepts piece_ids for batched execution.

iclips_pieces_write_checklist input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "piece_id": {
      "type": "number"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_pieces_write_checklist annotations
{
  "title": "iclips_pieces_write_checklist",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
iclips_pieces_delete
Advertised by the server during the last successful anonymous check.
Advertised destructive

Exclui peças do catálogo do iClips (o provider faz exclusão lógica). Aceita piece_ids para remover várias de uma vez, em lote, com erro reportado por id.

iclips_pieces_delete input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "piece_ids"
  ],
  "properties": {
    "account": {
      "type": "string"
    },
    "piece_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_pieces_delete annotations
{
  "title": "iclips_pieces_delete",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}
iclips_workflow_templates_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê os modelos de workflow configurados na agência no iClips. Ações: - list: todos os templates com id, nome e descricao (sem o workflowJson). - get: detalhe de um ou mais templates por template_ids, incluindo o workflowJson completo (em lote, com erro reportado por id). Use o id como basedOnTemplateId ao criar uma peça com iclips_pieces_write. [Flattened action: list]

iclips_workflow_templates_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    },
    "template_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_workflow_templates_list annotations
{
  "title": "iclips_workflow_templates_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_workflow_templates_get
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lê os modelos de workflow configurados na agência no iClips. Ações: - list: todos os templates com id, nome e descricao (sem o workflowJson). - get: detalhe de um ou mais templates por template_ids, incluindo o workflowJson completo (em lote, com erro reportado por id). Use o id como basedOnTemplateId ao criar uma peça com iclips_pieces_write. [Flattened action: get]

iclips_workflow_templates_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    },
    "template_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}
iclips_workflow_templates_get annotations
{
  "title": "iclips_workflow_templates_get",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_piece_categories_list
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as categorias de peça disponíveis na agência (id e nome). Ações: - list: a lista completa de categorias. - dropdown: as mesmas categorias no formato simplificado que o iClips serve para campos de seleção. Use esses ids em categoriaIds ao criar ou atualizar uma peça. [Flattened action: list]

iclips_piece_categories_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
iclips_piece_categories_list annotations
{
  "title": "iclips_piece_categories_list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_piece_categories_dropdown
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as categorias de peça disponíveis na agência (id e nome). Ações: - list: a lista completa de categorias. - dropdown: as mesmas categorias no formato simplificado que o iClips serve para campos de seleção. Use esses ids em categoriaIds ao criar ou atualizar uma peça. [Flattened action: dropdown]

iclips_piece_categories_dropdown input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
iclips_piece_categories_dropdown annotations
{
  "title": "iclips_piece_categories_dropdown",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
iclips_projects_extract
Advertised by the server during the last successful anonymous check.
Advertised read-only

Extrai do iClips a hierarquia completa de projetos de um período: Jobs, Peças, Workflows, Atividades e Tarefas, até os apontamentos de hora. É o endereço para BI, exportação e relatório. Responde o que as outras tools não respondem, como quem trabalhou quantas horas em qual peça de qual job de qual cliente, com o departamento e o valor/hora do executor. Exige dataInicio e dataFim (AAAA-MM-DDTHH:mm:ss, no máximo 31 dias de intervalo, filtrando pela data de entrada do job). Opcionalmente idCliente ou idGrupoCliente. Pagine com page e pageSize (padrão 20, máximo 50), lendo meta.totalCount. O iClips limita este endereço a 10 requisições por minuto por chave: varra mês a mês, não dispare em paralelo.

iclips_projects_extract input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "dataInicio",
    "dataFim"
  ],
  "properties": {
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "dataFim": {
      "type": "string"
    },
    "pageSize": {
      "type": "number"
    },
    "idCliente": {
      "type": "number"
    },
    "dataInicio": {
      "type": "string"
    },
    "idGrupoCliente": {
      "type": "number"
    }
  }
}
iclips_projects_extract annotations
{
  "title": "iclips_projects_extract",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
show_version
Advertised by the server during the last successful anonymous check.
Advertised read-only

Show the current MCP platform and adapter versions.

show_version input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
show_version annotations
{
  "title": "Show Version",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
report_bug
Advertised by the server during the last successful anonymous check.

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

report_bug input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "context": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    }
  }
}
report_bug annotations
{
  "title": "Report Bug",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
connect
Advertised by the server during the last successful anonymous check.
Advertised read-only

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

connect input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
connect annotations
{
  "title": "Connection Status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
toolkit_info
Advertised by the server during the last successful anonymous check.
Advertised read-only

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

toolkit_info input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
toolkit_info annotations
{
  "title": "Toolkit Info",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
marketplace
Advertised by the server during the last successful anonymous check.
Open-world

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

marketplace input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 10
    },
    "query": {
      "type": "string",
      "default": ""
    },
    "action": {
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ],
      "type": "string",
      "default": "search"
    },
    "mcp_id": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string",
      "default": ""
    },
    "tool_id": {
      "type": "string",
      "default": ""
    },
    "arguments": {
      "type": "string",
      "default": "{}"
    },
    "immediate": {
      "type": "boolean",
      "default": false
    },
    "tier_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_body": {
      "type": "string",
      "default": ""
    },
    "prompt_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_tool": {
      "type": "string",
      "default": ""
    },
    "prompt_vars": {
      "type": "string",
      "default": "{}"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    },
    "prompt_title": {
      "type": "string",
      "default": ""
    },
    "request_name": {
      "type": "string",
      "default": ""
    },
    "cancel_reason": {
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ],
      "type": "string"
    },
    "cancel_comment": {
      "type": "string",
      "default": ""
    },
    "prompt_targets": {
      "type": "array",
      "items": {
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ],
        "type": "string"
      },
      "default": []
    },
    "report_context": {
      "type": "string",
      "default": ""
    },
    "prompt_category": {
      "type": "string",
      "default": ""
    },
    "request_details": {
      "type": "string",
      "default": ""
    },
    "prompt_description": {
      "type": "string",
      "default": ""
    }
  }
}
marketplace annotations
{
  "title": "Marketplace",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
authenticate
Advertised by the server during the last successful anonymous check.

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

authenticate input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  }
}
authenticate annotations
{
  "title": "Authenticate",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
515 ms
95th percentile latency
515 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 515 ms · metadata changed · 30 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http iclips-mcp https://api.mcp.ai/p_iclips

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add iclips-mcp --url https://api.mcp.ai/p_iclips

Cursor

Merge this server into .cursor/mcp.json in your project, then enable iclips-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "iclips-mcp": {
      "url": "https://api.mcp.ai/p_iclips"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "iclips-mcp": {
      "type": "streamableHttp",
      "url": "https://api.mcp.ai/p_iclips",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start iclips-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "iclips-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_iclips"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http iclips-mcp https://api.mcp.ai/p_iclips

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.mcp.ai/p_iclips

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "iclips-mcp": {
      "serverUrl": "https://api.mcp.ai/p_iclips"
    }
  }
}

Let your agent find its tools

Find servers like mcp-dir iClips MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.