{
  "info": {
    "name": "Base de Conhecimento — mcp.ai",
    "description": "REST API for the Base de Conhecimento 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/kb",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "kb_add_text",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/text",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "text"
          ]
        },
        "description": "Adiciona um texto colado à base (vira um documento indexado e buscável). Útil pra notas, trechos, anotações.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"text\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_get_document",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/document",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "document"
          ]
        },
        "description": "Metadados + status de um documento específico (sem o texto cru).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"document_id\": \"\",\n  \"account\": \"\",\n  \"document_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_ingest_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/ingest/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "ingest",
            "url"
          ]
        },
        "description": "Baixa um arquivo de uma URL (.md/.txt/.docx) e o indexa na base. Bom pra ingerir um documento remoto sem upload manual.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"filename\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_list_accounts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/accounts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "accounts"
          ]
        },
        "description": "Lista as bases de conhecimento conectadas neste install. Retorna cada base com id, rótulo e um flag is_default (true quando só há uma — não precisa passar `account` nas outras tools). Com várias bases",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_list_documents",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/documents",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "documents"
          ]
        },
        "description": "Lista os documentos da base (id, nome, status, tamanho, nº de chunks).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_remove_document",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/remove/document",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "remove",
            "document"
          ]
        },
        "description": "Remove um ou mais documentos da base (apaga o original, os chunks e o índice). Aceita uma lista de ids.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"document_ids\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "kb_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search"
          ]
        },
        "description": "Busca semântica na base de conhecimento. Devolve os trechos (chunks) mais relevantes pra usar como contexto, com nome do arquivo de origem e score. Retrieval-only: você sintetiza a resposta a partir d",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\",\n  \"top_k\": 0,\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}