mcp-brazil-marketplaces
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_BR_LOG_LEVEL | No | Nível do logger mcp_brazil_marketplaces | WARNING |
| MCP_BR_MAX_RETRIES | No | Tentativas no fetcher OLX (retry + troca de perfil) | 4 |
| MCP_BR_DISABLE_JINA | No | Desabilita fallback via r.jina.ai | 0 |
| MCP_BR_ML_USER_AGENT | No | Sobrescreve UA usado no Mercado Livre. Use se o spoof de Googlebot for inaceitável — ML geralmente devolverá a página anti-bot e a tool retornará lista vazia. | |
| MCP_BR_REQUEST_TIMEOUT | No | Timeout HTTP em segundos | 25.0 |
| MCP_BR_RATE_LIMIT_MIN_GAP | No | Gap mínimo em segundos entre requests ao mesmo host. 0 desabilita | 0.5 |
| MCP_BR_WARMUP_PROBABILITY | No | Chance de warm-up da homepage antes do search | 0.7 |
| MCP_BR_RATE_LIMIT_CONCURRENCY | No | Máx. de requests HTTP simultâneos | 2 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| olx_buscar_anunciosA | Busca anúncios públicos na OLX Brasil com filtros de texto, estado, categoria, preço e ordenação. Retorna lista paginada de anúncios com título, preço, localização, data, URL e propriedades extras. Args: params (BuscarAnunciosInput): - query (str): Termo de busca obrigatório. - estado (Optional[str]): Sigla do estado ('sp', 'go', etc.). Padrão: todo Brasil. - categoria (Optional[str]): Slug de categoria OLX. Ex: 'informatica-e-acessorios'. - preco_min (Optional[int]): Preço mínimo em reais. - preco_max (Optional[int]): Preço máximo em reais. - ordenar (str): 'relevance' | 'price' | 'date'. Padrão: 'relevance'. - pagina (int): Número da página (1–50). Padrão: 1. Returns: str: JSON com campos: - total (int): Total de anúncios encontrados. - pagina (int): Página atual. - por_pagina (int): Anúncios por página. - url_busca (str): URL utilizada na busca. - anuncios (list): Lista de anúncios com id, titulo, preco, categoria, localizacao, bairro, data, url, imagem, profissional, entrega_olx, propriedades. |
| olx_detalhe_anuncioA | Obtém detalhes completos de um anúncio específico da OLX a partir da URL. Args: params (DetalheAnuncioInput): - url (str): URL completa do anúncio na OLX. Returns: str: JSON com campos: - id (int): ID do anúncio (list_id). - titulo (str): Título do anúncio. - descricao (str): Descrição completa (HTML removido). - preco (str): Preço formatado. - categoria (str): Categoria principal. - subcategoria (str): Subcategoria. - estado (str): UF do anúncio. - municipio (str): Cidade. - bairro (str): Bairro. - vendedor (str): Nome do vendedor. - profissional (bool): Se é anunciante profissional. - data (str): Data de publicação formatada. - imagens (list[str]): Lista de URLs das imagens. - propriedades (dict): Atributos específicos da categoria. - url (str): URL canônica do anúncio. |
| ml_buscar_anunciosA | Busca anúncios no Mercado Livre Brasil. Args: params (BuscarMLInput): - query (str): Termo obrigatório. - preco_min/preco_max (Optional[int]): Faixa de preço em reais. - estado (Optional[str]): Filtro pós-scraping por sigla UF (heurística). - condicao (Optional[str]): 'novo' ou 'usado'. - pagina (int): Página (50 itens por página). Returns: str: JSON com lista de anúncios (titulo, preco, frete, atributos, url, imagem). |
| ml_detalhe_anuncioA | Obtém detalhes de um anúncio do Mercado Livre a partir da URL. Args: params (DetalheMLInput): - url (str): URL completa do anúncio. Returns: str: JSON com campos comuns (id, titulo, preco, url, fonte) + descricao, imagens, vendedor. Em caso de erro: {"erro": "..."}. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a clear, unique purpose, differentiated by marketplace (ml_ vs olx_) and action (buscar vs detalhe). No overlap.
All tools follow a consistent snake_case pattern with marketplace prefix + verb + noun, all in Portuguese, making naming predictable.
4 tools is well-scoped for covering two marketplaces with essential search and detail operations, fitting the common 3-15 range.
Covers core read operations for both marketplaces, but lacks write capabilities and some advanced filters (e.g., category list). Minor gaps.