{
  "info": {
    "name": "AdvBox — mcp.ai",
    "description": "REST API for the AdvBox MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/advbox",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "advbox_create_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "customer"
          ]
        },
        "description": "Cria um novo contato/cliente. Campos conforme a API oficial (ex.: name, type, cpf/cnpj, email, phone) — envie o restante via `extra`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"email\": \"\",\n  \"cpf\": \"\",\n  \"cnpj\": \"\",\n  \"extra\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_create_lawsuit",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/lawsuit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "lawsuit"
          ]
        },
        "description": "Cria um processo. Campos conforme a API oficial (use advbox_settings para descobrir IDs de tipo/responsável); envie via campos nomeados + `extra`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"number\": \"\",\n  \"extra\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_create_movement",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/movement",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "movement"
          ]
        },
        "description": "Adiciona uma movimentação manual a um processo. Vincule ao processo (campo conforme a API oficial) + descrição; demais campos via `extra`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"description\": \"\",\n  \"extra\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_create_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "post"
          ]
        },
        "description": "Cria um novo post/anotação. Campos conforme a API oficial via campos nomeados + `extra`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"\",\n  \"extra\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_create_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "transaction"
          ]
        },
        "description": "Cria um lançamento financeiro (receita ou despesa). Campos conforme a API oficial (ex.: type, value, due_date) via campos nomeados + `extra`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"value\": \"\",\n  \"due_date\": \"\",\n  \"extra\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_customers_birthdays",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/customers/birthdays",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "customers",
            "birthdays"
          ]
        },
        "description": "Lista aniversariantes (para campanhas de relacionamento).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_get_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "customer"
          ]
        },
        "description": "Busca os dados completos de um contato por ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"query\": {},\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_get_lawsuit",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/lawsuit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "lawsuit"
          ]
        },
        "description": "Busca um processo por ID (dados completos).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"query\": {},\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_get_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "transaction"
          ]
        },
        "description": "Detalha uma transação por ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"query\": {},\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_last_movements",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/last/movements",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "last",
            "movements"
          ]
        },
        "description": "Última atualização de cada processo (resumo recente).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_lawsuit_history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lawsuit/history",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lawsuit",
            "history"
          ]
        },
        "description": "Histórico completo de um processo.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"lawsuit_id\": \"\",\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {},\n  \"lawsuit_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_lawsuit_movements",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lawsuit/movements",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lawsuit",
            "movements"
          ]
        },
        "description": "Lista todas as movimentações de um processo.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"lawsuit_id\": \"\",\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {},\n  \"lawsuit_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_list_customers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/customers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "customers"
          ]
        },
        "description": "Lista clientes/contatos com filtros avançados (nome, cpf, cnpj, e-mail etc. via `query`).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"name\": \"\",\n  \"cpf\": \"\",\n  \"cnpj\": \"\",\n  \"email\": \"\",\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_list_lawsuits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/lawsuits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "lawsuits"
          ]
        },
        "description": "Lista/busca processos (22+ filtros). Filtros comuns via `query`: numero, parte, cpf, cnpj, responsavel, status, comarca, uf, datas.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"number\": \"\",\n  \"cpf\": \"\",\n  \"cnpj\": \"\",\n  \"status\": \"\",\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_list_posts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/posts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "posts"
          ]
        },
        "description": "Lista posts e anotações (tarefas/notas).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_list_transactions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/transactions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "transactions"
          ]
        },
        "description": "Lista transações financeiras com filtros de data/tipo/status (via `query`).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"type\": \"\",\n  \"status\": \"\",\n  \"start_date\": \"\",\n  \"end_date\": \"\",\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_publications",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/publications",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "publications"
          ]
        },
        "description": "Lista as publicações oficiais de um processo.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"lawsuit_id\": \"\",\n  \"page\": 0,\n  \"page_size\": 0,\n  \"query\": {},\n  \"lawsuit_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_settings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/settings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "settings"
          ]
        },
        "description": "Obtém todos os IDs e configurações da conta (usuários, origens, tipos de tarefa, fases, tipos de processo). Use para descobrir os IDs exigidos por create/update.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_update_lawsuit",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/lawsuit",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "lawsuit"
          ]
        },
        "description": "Atualiza um processo existente por ID. Envie só os campos a alterar (nomeados + `extra`).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"extra\": {},\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "advbox_update_transaction",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/transaction",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "transaction"
          ]
        },
        "description": "Atualiza valor, vencimento ou status de pagamento de uma transação por ID. Envie só os campos a alterar (nomeados + `extra`).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"value\": \"\",\n  \"due_date\": \"\",\n  \"status\": \"\",\n  \"extra\": {},\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}