{
  "info": {
    "name": "Mercado Livre Vendedor — mcp.ai",
    "description": "REST API for the Mercado Livre Vendedor 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/mercadolivre",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "mercadolivre_get_category",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/category",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "category"
          ]
        },
        "description": "Detalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_get_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "items"
          ]
        },
        "description": "Detalha um ou mais anúncios por id (GET /items?ids=). Informe `ids` (lista, máx 20). Filtro opcional `attributes` (campos a retornar, separados por vírgula).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"attributes\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_get_order",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/order",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "order"
          ]
        },
        "description": "Detalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_get_question",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/question",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "question"
          ]
        },
        "description": "Detalha uma pergunta por id (GET /questions/{id}).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_get_shipment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/shipment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "shipment"
          ]
        },
        "description": "Detalha um envio por id (GET /shipments/{id}): status, rastreio, endereço, custo. Pegue o shipping.id no detalhe do pedido (mercadolivre_get_order).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_get_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "user"
          ]
        },
        "description": "Detalha um usuário público por id (GET /users/{id}).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_item_visits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/item/visits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "item",
            "visits"
          ]
        },
        "description": "Visitas de um anúncio numa janela de tempo (GET /items/{id}/visits/time_window). Informe `last` (quantidade) e `unit` (day, week, month).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"last\": 0,\n  \"unit\": \"\",\n  \"account\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_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 contas Mercado Livre conectadas a este install — id, label, seller_id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_list_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "categories"
          ]
        },
        "description": "Lista as categorias raiz de um site (GET /sites/{site}/categories). `site` default MLB.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"site\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_list_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "items"
          ]
        },
        "description": "Lista os ids dos anúncios do vendedor conectado (GET /users/{seller}/items/search). Paginado (offset/limit). Filtro opcional `status` (active, paused, closed). Retorna ids + paging; use mercadolivre_g",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"offset\": 0,\n  \"limit\": 0,\n  \"status\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_list_orders",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/orders",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "orders"
          ]
        },
        "description": "Lista pedidos do vendedor conectado (GET /orders/search?seller=). Paginado. Filtros opcionais: `order.status` (paid, confirmed, cancelled...), `sort` (date_asc/date_desc), `q` (busca).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"offset\": 0,\n  \"limit\": 0,\n  \"status\": \"\",\n  \"sort\": \"\",\n  \"q\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_list_questions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/questions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "questions"
          ]
        },
        "description": "Lista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=). Paginado. Filtros opcionais: `status` (UNANSWERED, ANSWERED), `item` (id do anúncio).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"offset\": 0,\n  \"limit\": 0,\n  \"status\": \"\",\n  \"item\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_me",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/me",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "me"
          ]
        },
        "description": "Dados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mercadolivre_search_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "items"
          ]
        },
        "description": "Busca anúncios do vendedor já com detalhes (GET /sites/{site}/search?seller_id=). Paginado. `site` default MLB (Brasil). Filtro opcional `q` (texto), `category`.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"offset\": 0,\n  \"limit\": 0,\n  \"site\": \"\",\n  \"q\": \"\",\n  \"category\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}