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.
https://api.mcp.ai/p_iclipsWhat its tools do
30 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (16)
iclips_list_accountsiclips_financial_accountsiclips_financial_entries_listiclips_financial_entries_geticlips_financial_invoices_listiclips_financial_invoices_geticlips_pieces_listiclips_pieces_geticlips_workflow_templates_listiclips_workflow_templates_geticlips_piece_categories_listiclips_piece_categories_dropdowniclips_projects_extractshow_versionconnecttoolkit_info
Can change data (14)
iclips_jobs_write_createiclips_jobs_write_updateiclips_jobs_deleteiclips_job_pieces_write_addiclips_job_pieces_write_updateiclips_job_tasks_write_createiclips_job_tasks_write_updateiclips_pieces_write_createiclips_pieces_write_updateiclips_pieces_write_checklisticlips_pieces_deletereport_bugmarketplaceauthenticate
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
- 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
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
30 advertised
iclips_list_accounts
Lista as agências iClips (chaves de API) ligadas a este install, com id, apelido e nome.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
}
}
}{
"title": "iclips_list_accounts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_financial_accounts
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
}
}
}{
"title": "iclips_financial_accounts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_financial_entries_list
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]
{
"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"
}
}
}{
"title": "iclips_financial_entries_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_financial_entries_get
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]
{
"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"
}
}
}{
"title": "iclips_financial_entries_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_financial_invoices_list
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]
{
"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"
}
}
}
}{
"title": "iclips_financial_invoices_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_financial_invoices_get
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]
{
"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"
}
}
}
}{
"title": "iclips_financial_invoices_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_jobs_write_create
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.
{
"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"
}
}
}
}{
"title": "iclips_jobs_write_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_jobs_write_update
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.
{
"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"
}
}
}
}{
"title": "iclips_jobs_write_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_jobs_delete
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_ids"
],
"properties": {
"account": {
"type": "string"
},
"job_ids": {
"type": "array",
"items": {
"type": "number"
}
}
}
}{
"title": "iclips_jobs_delete",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}iclips_job_pieces_write_add
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.
{
"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"
}
}
}
}{
"title": "iclips_job_pieces_write_add",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_job_pieces_write_update
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.
{
"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"
}
}
}
}{
"title": "iclips_job_pieces_write_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_job_tasks_write_create
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.
{
"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"
}
}
}
}{
"title": "iclips_job_tasks_write_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_job_tasks_write_update
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.
{
"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"
}
}
}
}{
"title": "iclips_job_tasks_write_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_pieces_list
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]
{
"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"
}
}
}{
"title": "iclips_pieces_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_pieces_get
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]
{
"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"
}
}
}{
"title": "iclips_pieces_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_pieces_write_create
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.
{
"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"
}
}
}
}{
"title": "iclips_pieces_write_create",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_pieces_write_update
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.
{
"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"
}
}
}
}{
"title": "iclips_pieces_write_update",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_pieces_write_checklist
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.
{
"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"
}
}
}
}{
"title": "iclips_pieces_write_checklist",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}iclips_pieces_delete
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"piece_ids"
],
"properties": {
"account": {
"type": "string"
},
"piece_ids": {
"type": "array",
"items": {
"type": "number"
}
}
}
}{
"title": "iclips_pieces_delete",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}iclips_workflow_templates_list
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]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
},
"template_ids": {
"type": "array",
"items": {
"type": "number"
}
}
}
}{
"title": "iclips_workflow_templates_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_workflow_templates_get
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]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
},
"template_ids": {
"type": "array",
"items": {
"type": "number"
}
}
}
}{
"title": "iclips_workflow_templates_get",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_piece_categories_list
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]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
}
}
}{
"title": "iclips_piece_categories_list",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_piece_categories_dropdown
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]
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"account": {
"type": "string"
}
}
}{
"title": "iclips_piece_categories_dropdown",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}iclips_projects_extract
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.
{
"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"
}
}
}{
"title": "iclips_projects_extract",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}show_version
Show the current MCP platform and adapter versions.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Show Version",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"message"
],
"properties": {
"context": {
"type": "string",
"default": ""
},
"message": {
"type": "string"
},
"conversation": {
"type": "string",
"default": "[]"
}
}
}{
"title": "Report Bug",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}connect
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Connection Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Toolkit Info",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}marketplace
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.
{
"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": ""
}
}
}{
"title": "Marketplace",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}authenticate
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"token": {
"type": "string"
}
}
}{
"title": "Authenticate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
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.
Claude Code
claude mcp add --transport http iclips-mcp https://api.mcp.ai/p_iclipsCodex
codex mcp add iclips-mcp --url https://api.mcp.ai/p_iclipsCursor
{
"mcpServers": {
"iclips-mcp": {
"url": "https://api.mcp.ai/p_iclips"
}
}
}Cline
{
"mcpServers": {
"iclips-mcp": {
"type": "streamableHttp",
"url": "https://api.mcp.ai/p_iclips",
"disabled": false
}
}
}VS Code
{
"servers": {
"iclips-mcp": {
"type": "http",
"url": "https://api.mcp.ai/p_iclips"
}
}
}Gemini CLI
gemini mcp add --transport http iclips-mcp https://api.mcp.ai/p_iclipsClaude Desktop
https://api.mcp.ai/p_iclipsWindsurf
{
"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.