imoblist MCP ● online

Servidor Model Context Protocol · protocolo 2025-11-25 · JSON-RPC 2.0 · Streamable HTTP · somente leitura.

Endpoint & autenticação

POST https://mcp.imoblist.com/ — corpo JSON-RPC 2.0.
Header obrigatório Authorization: Bearer <API_TOKEN>. O acesso é restrito a parceiros autorizados: o token não é auto-gerado nem distribuído a clientes finais e só pode ser fornecido pela equipe imoblist. Para solicitar acesso, fale com a nossa equipe. Sem Origin exigido (server-to-server). Métodos: initialize, tools/list, tools/call, ping.

Tools

Tool	Argumentos	Retorno
`get_realestate_basic`	id (int), format?	Imóvel enxuto (capa, endereço, preços-chave) + contato da imobiliária.
`get_realestate_full`	id (int), format?	Imóvel completo (tipo, áreas, características, info, até 10 fotos) + contato.
`get_account_basic`	id (int), format?	Dados da imobiliária pelo id (nome, e-mail, telefone, WhatsApp, endereço).
`search_realestates`	filtros, format?	Busca imóveis de qualquer imobiliária (5 por página).
`search_realestates_by_account`	account_id, filtros, format?	Busca restrita à imobiliária do account_id informado.

Filtros de busca

account_id (obrigatório na busca por imobiliária) · type (ex: Casa, Apartamento) · city · state (UF) · neighborhood · bedrooms (mínimo) · minPrice · maxPrice · page (1) · perPage (5, máx 5).

Tipos disponíveis (filtro `type`)

Valores aceitos no filtro type (lista atualizada automaticamente).

Tipo
Apartamento
Casa
Chácara
Fazenda
Galpão/Barracão
Garagem
Negócio
Prédio
Sala/Salão
Sítio
Sobrado
Terreno

Formato de saída

format opcional: ausente = json (structuredContent); markdown ou html quando informado.

Disponibilidade

Só imóveis publicados e imobiliárias liberadas. Caso contrário retorna available:false com realestate_unavailable ou account_unavailable; id inexistente → not_found. O proprietário (owner) nunca é exposto.

Prompt inicial (initialize)

Texto enviado à IA no handshake — descreve as tools e os tipos que ela pode consultar:

Consulta de imóveis publicados da imoblist. Por ID: get_realestate_basic (barato) e get_realestate_full (até 10 fotos), ambas com o contato da imobiliária; get_account_basic retorna só a imobiliária pelo id (vem no bloco account). Busca com filtros (type, city, state, neighborhood, bedrooms, minPrice, maxPrice): search_realestates (qualquer imobiliária) e search_realestates_by_account (informe account_id, o id do bloco account). A busca devolve 5 por página; use o id para detalhar. Tipos válidos no filtro type: Apartamento, Casa, Chácara, Fazenda, Galpão/Barracão, Garagem, Negócio, Prédio, Sala/Salão, Sítio, Sobrado, Terreno.

Exemplo

curl -X POST https://mcp.imoblist.com/ \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_realestate_basic","arguments":{"id":12345}}}'