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
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools