Fixatia

Pesquise propriedades de leilão em dificuldades para investidores

Ver em fixatia.comExperimente este MCPPatrocinado

Documentação

Integração com Servidor MCP

Conecte o Claude e outros assistentes de IA ao banco de dados de propriedades da Fixatia usando o Model Context Protocol

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA como o Claude acessem fontes de dados externas com segurança. O servidor MCP da Fixatia fornece acesso em tempo real ao nosso banco de dados de leilões de propriedades europeias, permitindo que assistentes de IA pesquisem propriedades, recuperem detalhes e descubram filtros disponíveis.

Pesquise milhares de propriedades em leilão em 6 países europeus com filtros avançados

Obtenha detalhes abrangentes das propriedades, incluindo estimativas de reforma, cálculos de ROI e descrições multilíngues

Descubra opções de filtro disponíveis dinamicamente para criar consultas de pesquisa poderosas

Saiba mais sobre MCP

Início Rápido

1URL do Servidor

O servidor MCP da Fixatia está disponível em:

https://mcp.fixatia.com/api/mcp

2Configurar o Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fixatia": {
      "url": "https://mcp.fixatia.com/api/mcp"
    }
  }
}

3Comece a Usar

Reinicie o Claude Desktop e comece a fazer perguntas sobre propriedades. O Claude usará automaticamente as ferramentas da Fixatia para pesquisar e recuperar informações sobre propriedades.

Tente perguntar: "Encontre propriedades em Portugal abaixo de €150.000 com potencial de ROI de pelo menos 20%"

Ferramentas Disponíveis

O servidor MCP da Fixatia fornece quatro ferramentas poderosas para interagir com nosso banco de dados de propriedades:

search_properties

Pesquise propriedades em leilão imobiliário em toda a Europa. Filtre por país, cidade, preço, tipo de propriedade, potencial de ROI e muito mais. Retorna uma lista de propriedades correspondentes com detalhes principais, incluindo preços de leilão, valores de mercado e métricas de investimento.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
query	string	Opcional	Pesquisa de texto por título da propriedade, cidade ou região
country	string	Opcional	Código do país: es (Espanha), pt (Portugal), it (Itália), fr (França), de (Alemanha), hr (Croácia)
region	string	Opcional	Nome da região dentro do país
city	string	Opcional	Nome da cidade
propertyType	string	Opcional	Tipo de propriedade: APARTMENT, HOUSE, VILLA, LAND ou COMMERCIAL
minPrice	number	Opcional	Preço mínimo de leilão em EUR
maxPrice	number	Opcional	Preço máximo de leilão em EUR
minRoi	number	Opcional	Percentual mínimo de ROI (ex.: 20 para 20%)
bedrooms	number	Opcional	Número mínimo de quartos
maxResults	number	Opcional	Número máximo de resultados a retornar (padrão: 10, máximo: 50)
sortBy	string	Opcional	Ordem de classificação: newest, price-low, price-high, roi-high ou auction-soonest
locale	string	Opcional	Idioma para títulos/descrições (padrão: en). Suporta 18 idiomas.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_properties",
    "arguments": {
      "country": "pt",
      "maxPrice": 150000,
      "minRoi": 20,
      "maxResults": 5
    }
  },
  "id": 1
}

Exemplo de Resposta

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": {
        "totalCount": 12,
        "results": [
          {
            "id": "b45dc4fc14134da69e9f800f8",
            "title": "2-Bedroom Apartment · Lisbon",
            "country": "pt",
            "city": "Lisboa",
            "propertyType": "APARTMENT",
            "auctionPrice": 120000,
            "marketValue": 165000,
            "potentialRoi": 26.5,
            "bedrooms": 2,
            "squareMeters": 75
          }
        ]
      }
    }]
  }
}

get_property

Obtenha detalhes completos de uma propriedade específica pelo seu ID. Retorna informações abrangentes, incluindo descrições multilíngues, imagens, coordenadas de localização, estimativas de reforma, detalhes do leilão e métricas de investimento.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
id	string	Obrigatório	O ID da propriedade (obtido nos resultados da pesquisa)
locale	string	Opcional	Idioma para título/descrição (padrão: en). Suporta 18 idiomas.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

get_filter_options

Obtenha opções de filtro disponíveis, incluindo lista de países, regiões, cidades, tipos de propriedade e faixas de preço/ROI. Útil para entender quais parâmetros de pesquisa estão disponíveis e criar interfaces de filtro dinâmicas.

Esta ferramenta não aceita parâmetros.

Exemplo de Solicitação

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_filter_options",
    "arguments": {}
  },
  "id": 3
}

Exemplo de Resposta

{
  "countries": [
    { "code": "pt", "name": "Portugal", "propertyCount": 45 },
    { "code": "es", "name": "Spain", "propertyCount": 120 },
    { "code": "it", "name": "Italy", "propertyCount": 89 }
  ],
  "propertyTypes": [
    { "type": "APARTMENT", "count": 156 },
    { "type": "HOUSE", "count": 78 }
  ],
  "priceRange": { "min": 5000, "max": 800000 },
  "roiRange": { "min": -5, "max": 45 }
}

send_property_inquiry

OAuth 2.1

Envie uma consulta sobre uma propriedade para expressar interesse. Esta ferramenta requer autenticação OAuth 2.1 com PKCE.

Autenticação Necessária (OAuth 2.1)

Esta ferramenta usa OAuth 2.1 com PKCE para autenticação segura. O fluxo é:

O usuário clica em 'Autorizar' e faz login via pop-up do navegador
O código de autorização é trocado por um token de acesso (protegido por PKCE)
mcp.tools.sendPropertyInquiry.oauthStep3

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
propertyId	string	Obrigatório	O ID da propriedade sobre a qual consultar
message	string	Obrigatório	Sua mensagem de consulta, mínimo de 10 caracteres

Exemplo de Solicitação

// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
//   -H "Authorization: Bearer YOUR_TOKEN" \
//   -H "Content-Type: application/json" \
//   -d '...'

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_property_inquiry",
    "arguments": {
      "propertyId": "b45dc4fc14134da69e9f800f8",
      "message": "I'm interested in this property. Is it still available?"
    }
  },
  "id": 4
}

Exemplo de Resposta

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Inquiry sent successfully! The property owner will be notified and may contact you."
    }]
  }
}

Referência da API HTTP

O servidor MCP também expõe uma API HTTP direta para acesso programático. Todas as solicitações usam o protocolo JSON-RPC 2.0.

Endpoints

GET

/api/mcp

Verificação de integridade e informações do servidor. Retorna nome do servidor, versão, versão do protocolo e ferramentas disponíveis.

POST

/api/mcp

Solicitações JSON-RPC 2.0 para execução de ferramentas. Suporta os métodos initialize, tools/list, tools/call e ping.

Métodos Suportados

initialize - Inicializa a sessão MCP e obtém os recursos do servidor
tools/list - Lista todas as ferramentas disponíveis com seus esquemas
tools/call - Executa uma ferramenta específica com argumentos
ping - Verificação de integridade (ping)

Exemplo com cURL

curl -X POST https://mcp.fixatia.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_properties",
      "arguments": {
        "country": "pt",
        "maxPrice": 150000
      }
    },
    "id": 1
  }'

Experimente

Teste o servidor MCP diretamente do seu navegador. Selecione uma ferramenta e configure os parâmetros abaixo.

Selecione uma ferramenta

Tratamento de Erros

O servidor retorna respostas de erro padrão JSON-RPC 2.0. Aqui estão os códigos de erro comuns:

Código	Mensagem	Descrição
-32600	Invalid Request	O JSON enviado não é um objeto de Solicitação válido
-32601	Method not found	O método solicitado não existe ou não está disponível
-32602	Invalid params	Parâmetro(s) de método inválido(s) - verifique campos obrigatórios e tipos
-32603	Internal error	Erro interno de JSON-RPC ou problema no servidor

Exemplo de Resposta de Erro

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

Idiomas Suportados

Títulos e descrições de propriedades estão disponíveis em 18 idiomas. Use o parâmetro locale para obter conteúdo no seu idioma preferido:

Inglês (en), Alemão (de), Francês (fr), Espanhol (es), Italiano (it), Português (pt), Holandês (nl), Polonês (pl), Grego (el), Romeno (ro), Tcheco (cs), Húngaro (hu), Chinês (zh), Árabe (ar), Russo (ru), Japonês (ja), Coreano (ko), Croata (hr)

Documentação Legível por Máquina

Para assistentes de IA e ferramentas automatizadas, fornecemos arquivos de documentação em texto simples seguindo o padrão llms.txt:

Saiba mais sobre o padrão llms.txt em llmstxt.org

Precisa de Ajuda?

Se você tiver dúvidas sobre a integração com o servidor MCP da Fixatia ou encontrar algum problema, nossa equipe de suporte ao desenvolvedor está aqui para ajudar.