ObraAberta

Read-only MCP tools for public works, builders, ratings, timelines and nearby services in Brazil.

Should I use this

Quality & Safety

B
Description quality
73%
Schema completeness
77%
Naming quality
98%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • LOWTool 'search_projects' description lacks action verbin search_projects
  • LOWTool 'get_project_timeline' description lacks action verbin get_project_timeline
  • LOWTool 'get_builder' description lacks action verbin get_builder
  • LOWTool 'health' description lacks action verbin health

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,801Tokens (tool definitions)
~1.0 KBTypical response size
Moderate attention impact (1.41% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "obraaberta": {
      "url": "https://obraaberta.com.br/mcp"
    }
  }
}

Remote endpoints

https://obraaberta.com.br/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_projects(q, city, state, status, min_price, ...)

Busca empreendimentos publicados na ObraAberta por texto, cidade, estado, status, faixa de preço, dormitórios e amenidades. Somente dados públicos.

Input Schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Texto livre (nome, bairro, construtora).",
      "type": "string",
      "minLength": 1
    },
    "city": {
      "description": "Cidade.",
      "type": "string"
    },
    "state": {
      "description": "UF com duas letras, ex.: SP.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "status": {
      "description": "Estágio da obra, ex.: lancamento, em_construcao, entregue.",
      "type": "string"
    },
    "min_price": {
      "type": "number",
      "minimum": 0
    },
    "max_price": {
      "type": "number",
      "minimum": 0
    },
    "bedrooms": {
      "description": "Número de dormitórios.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "amenities": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "sort": {
      "type": "string"
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_project(id)

Consulta a ficha pública de um empreendimento da ObraAberta por slug ou UUID, com linha do tempo resumida e avaliações moderadas.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID do empreendimento."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢find_projects_nearby(latitude, longitude, radius_km, city, state, ...)

Lista empreendimentos publicados dentro de um raio a partir de uma latitude e longitude. Somente obras com coordenada registrada.

Input Schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius_km": {
      "default": 5,
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "status": {
      "type": "string"
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_project_timeline(id, order)

Consulta a linha do tempo pública de um empreendimento: etapas, percentuais e evidências já aprovadas na moderação.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID do empreendimento."
    },
    "order": {
      "default": "desc",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_project_ratings(id, page, limit)

Consulta o resumo e as avaliações públicas já moderadas de um empreendimento. Nenhum dado pessoal do autor é retornado.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID do empreendimento."
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_project_nearby_services(id, radius_km, types)

Lista escolas, hospitais, transporte e comércio próximos a um empreendimento, a partir do OpenStreetMap. Exige atribuição ODbL na exibição.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID do empreendimento."
    },
    "radius_km": {
      "default": 2,
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10
    },
    "types": {
      "description": "Tipos desejados, ex.: schools, health, transport, commerce.",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_builders(q, state, page, limit, sort, ...)

Lista construtoras e incorporadoras do diretório público da ObraAberta. Não retorna dados cadastrais internos nem contatos pessoais.

Input Schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Texto livre (nome ou nome anterior).",
      "type": "string",
      "minLength": 1
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "sort": {
      "type": "string"
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_builder(id)

Consulta a ficha pública de uma construtora e os indicadores públicos disponíveis, por slug ou UUID.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID da construtora."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_builder_projects(id, city, state, status, page, ...)

Lista os empreendimentos publicados vinculados a uma construtora do diretório público da ObraAberta.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Slug ou UUID da construtora."
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "status": {
      "type": "string"
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_public_sources

Lista as fontes públicas usadas pela ObraAberta, com a natureza de cada uma (oficial, pública, colaborativa, OpenStreetMap) e suas limitações.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢health

Verifica se a API pública da ObraAberta está disponível e qual versão responde.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Recommended Prompts

find_specific
Find [specific item] using ObraAberta
Expected tools: search_projects
fetch_info
Fetch [information type] using ObraAberta
Expected tools: get_project
search_research
Search for information about [topic] using ObraAberta
Expected tools: search_projects
retrieve_data
Get details about [item] from ObraAberta
Expected tools: get_project
list_items
List all [items] available in ObraAberta
Expected tools: list_builders

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools
verifiedversion not recorded11 tools