# iClips — MCP server on mcp.ai
> Advertising and marketing agency ERP and workflow on iClips (Public API v1). Read the full finance module (bank accounts, payables and receivables, invoices with withheld taxes), manage jobs, pieces, tasks and production checklists, and extract the entire project hierarchy with time entries per executor. Authenticated via API key (X-Api-Key) generated in the panel under Avatar, CHAVE DE API.

By: mcp.ai · official
Page: https://mcp.ai/iclips

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_iclips?ms=1788484560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/iclips/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/iclips/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/iclips/skill.md
Postman collection (v2.1): https://mcp.ai/iclips/postman.json

## Tools
- iclips_financial_accounts(account?: string) — Lista as contas bancárias ativas da agência no iClips (id, nome, isDefault, banco, agência e número da conta).
- iclips_financial_entries_get(from?: string, to?: string, date_field?: string, type?: string, account_id?: number, category_id?: number, dre_indicator?: string, destination_id?: number, job_id?: number, limit?: number, offset?: number, entry_ids?: number[], account?: string) — Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber).
- iclips_financial_entries_list(from?: string, to?: string, date_field?: string, type?: string, account_id?: number, category_id?: number, dre_indicator?: string, destination_id?: number, job_id?: number, limit?: number, offset?: number, entry_ids?: number[], account?: string) — Lê os lançamentos financeiros do iClips (entradas, saídas e o que está em aberto a pagar e a receber).
- iclips_financial_invoices_get(from?: string, to?: string, status?: string, limit?: number, offset?: number, invoice_ids?: number[], account?: string) — Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips.
- iclips_financial_invoices_list(from?: string, to?: string, status?: string, limit?: number, offset?: number, invoice_ids?: number[], account?: string) — Lê as notas fiscais de serviço (NFS-e) emitidas pela agência no iClips.
- iclips_job_pieces_write_add(job_id: number, job_piece_id?: number, data: string, account?: string, job_ids?: number[], job_piece_ids?: number[]) — Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele.
- iclips_job_pieces_write_update(job_id: number, job_piece_id?: number, data: string, account?: string, job_ids?: number[], job_piece_ids?: number[]) — Vincula uma peça do catálogo a um job existente, ou atualiza uma peça já vinculada a ele.
- iclips_job_tasks_write_create(job_id: number, task_id?: number, data: string, account?: string, job_ids?: number[], task_ids?: number[]) — Cria ou atualiza uma tarefa manual dentro de um job existente no iClips.
- iclips_job_tasks_write_update(job_id: number, task_id?: number, data: string, account?: string, job_ids?: number[], task_ids?: number[]) — Cria ou atualiza uma tarefa manual dentro de um job existente no iClips.
- iclips_jobs_delete(job_ids: number[], account?: string) — Exclui jobs (projetos) do iClips. É destrutivo e não tem desfazer pela API.
- iclips_jobs_write_create(job_id?: number, data: string, account?: string, job_ids?: number[]) — Cria ou atualiza um job (projeto) no iClips.
- iclips_jobs_write_update(job_id?: number, data: string, account?: string, job_ids?: number[]) — Cria ou atualiza um job (projeto) no iClips.
- iclips_list_accounts(account?: string) — Lista as agências iClips (chaves de API) ligadas a este install, com id, apelido e nome.
- iclips_piece_categories_dropdown(account?: string) — Lista as categorias de peça disponíveis na agência (id e nome).
- iclips_piece_categories_list(account?: string) — Lista as categorias de peça disponíveis na agência (id e nome).
- iclips_pieces_delete(piece_ids: number[], account?: string) — Exclui peças do catálogo do iClips (o provider faz exclusão lógica).
- iclips_pieces_get(q?: string, categoria?: string, status?: string, basedOnTemplateId?: string, page?: number, pageSize?: number, piece_ids?: number[], account?: string) — Lê o catálogo de peças da agência no iClips.
- iclips_pieces_list(q?: string, categoria?: string, status?: string, basedOnTemplateId?: string, page?: number, pageSize?: number, piece_ids?: number[], account?: string) — Lê o catálogo de peças da agência no iClips.
- iclips_pieces_write_checklist(piece_id?: number, data: string, account?: string, piece_ids?: number[]) — Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist.
- iclips_pieces_write_create(piece_id?: number, data: string, account?: string, piece_ids?: number[]) — Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist.
- iclips_pieces_write_update(piece_id?: number, data: string, account?: string, piece_ids?: number[]) — Cria ou atualiza uma peça no catálogo do iClips, ou marca um item do checklist.
- iclips_projects_extract(dataInicio: string, dataFim: string, idCliente?: number, idGrupoCliente?: number, page?: number, pageSize?: number, account?: string) — Extrai do iClips a hierarquia completa de projetos de um período: Jobs, Peças, Workflows, Atividades e Tarefas, até os apontamentos de hora.
- iclips_workflow_templates_get(template_ids?: number[], account?: string) — Lê os modelos de workflow configurados na agência no iClips.
- iclips_workflow_templates_list(template_ids?: number[], account?: string) — Lê os modelos de workflow configurados na agência no iClips.

## Example prompts
- "How much does the agency have payable this month, and to which suppliers"
- "How many hours did each person log on client X's pieces in January"
- "Create a job for client 42 with the briefing and approval tasks"

## Links
Docs: https://mcp.ai/docs/mcps/iclips
Website: https://mcp.ai/mcps/iclips