Conecte sua IA ao Portal de Dados Abertos

Use o servidor MCP do Portal para consultar os dados abertos direto do seu assistente de IA — Claude, Cursor, VS Code e outros.

Endpoint · MCP · Streamable HTTP · sem autenticação
https://mcp.dados.tiago.ons.org.br/

Conectar no seu cliente

A maioria conecta apontando a URL direto. Kiro e Claude Desktop forçam descoberta OAuth — para eles, use a ponte local mcp-remote (mostrada na aba), que fala com o servidor anônimo sem exigir login.

Conecta direto na URL, sem ponte. No terminal, rode:

claude mcp add --transport http ons-tiago-dadosabertos https://mcp.dados.tiago.ons.org.br/

Conecta direto na URL.

Adicionar ao Cursor

Ou adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "type": "http",
      "url": "https://mcp.dados.tiago.ons.org.br/"
    }
  }
}

Conecta direto na URL.

Instalar no VS Code

Ou adicione em .vscode/mcp.json:

{
  "servers": {
    "ons-tiago-dadosabertos": {
      "type": "http",
      "url": "https://mcp.dados.tiago.ons.org.br/"
    }
  }
}

O Kiro força descoberta OAuth, então use a ponte local mcp-remote. Adicione em ~/.kiro/settings/mcp.json.

No macOS / Linux:

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.dados.tiago.ons.org.br/"
      ]
    }
  }
}

No Windows (o npx precisa passar por cmd /c):

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://mcp.dados.tiago.ons.org.br/"
      ]
    }
  }
}

A ponte roda via npx (Node.js) e é baixada na 1ª conexão. Requer Node.js instalado.

Duas opções:

1. Conectores: Configurações → Conectores → Adicionar conector personalizado e cole a URL do endpoint acima.

2. Ponte mcp-remote: se os Conectores pedirem login, adicione em claude_desktop_config.json (Configurações → Desenvolvedor → Editar config).

No macOS / Linux:

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.dados.tiago.ons.org.br/"
      ]
    }
  }
}

No Windows (o npx precisa passar por cmd /c):

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "mcp-remote",
        "https://mcp.dados.tiago.ons.org.br/"
      ]
    }
  }
}

A ponte roda via npx (Node.js) e é baixada na 1ª conexão. Requer Node.js instalado.

Config MCP genérica (Streamable HTTP) — para clientes que conectam direto na URL:

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "type": "http",
      "url": "https://mcp.dados.tiago.ons.org.br/"
    }
  }
}

Se o seu cliente falha exigindo OAuth, use a ponte local mcp-remote:

{
  "mcpServers": {
    "ons-tiago-dadosabertos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.dados.tiago.ons.org.br/"
      ]
    }
  }
}

O que dá pra fazer

  • buscar_dataset
    Busca datasets candidatos do ONS por tema (busca semântica).
    ex.: "carga de energia por subsistema"
  • descrever_dataset
    Retorna a visão do contrato do dataset: schema, colunas, tipos e exemplos de SQL.
    ex.: "carga-energia"
  • executar_sql
    Executa SQL DuckDB (read-only) direto nos Parquet do S3 do ONS.
    ex.: "SELECT ... FROM carga_energia WHERE ..."
  • analisar
    Pipeline ponta-a-ponta: seleciona o dataset, lê o contrato, gera o SQL, executa e formata a resposta.
    ex.: "Qual a carga de energia por subsistema em 2025?"