ObraAberta
Read-only MCP tools for public works, builders, ratings, timelines and nearby services in Brazil.
Should I use this
Quality & Safety
Findings (4)
- LOWin search_projects
- LOWin get_project_timeline
- LOWin get_builder
- LOWin health
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (11)
🟢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
search_projectsget_projectsearch_projectsget_projectlist_buildersCommunity
Evidence