exascale.build

npx add-mcp 'https://api.exascale.build/mcp'

O buildout, como seu agente o chama.

Filas de interconexão de ISOs dos EUA e dados energéticos citados. 25 consultas gratuitas, depois $49/mês ou $490/ano. Dois transportes, um contrato — chame via MCP ou REST e obtenha JSON idêntico e citado. A referência autoritativa e legível por máquina é sempre o /v1/capabilities ao vivo e o schema describe de cada ferramenta.

Precisa de campos exatos e exemplos? A referência completa gerada publica os filtros, métricas, citações, ressalvas e exemplos JSON verificados de cada capacidade.

Navegue pela referência completa da API →

O ciclo

Projetado para que um agente nunca precise adivinhar:

descobrir → descrever → consultar → verificar

• descobrir — list_capabilities lista cada ponto de dados + como eles se unem (âncoras).
• descrever — o schema de cada ferramenta retorna seus filtros exatos, agrupamentos, medidas e o que ela não responde.
• consultar — filtros + group_by + order_by / top_n no lado do servidor → linhas citadas + resumo.
• verificar — get_source_evidence reabre o arquivo bruto, recalcula o hash (SHA-256) e retorna a célula literal da fonte.

Duas superfícies, um contrato

Superfície	Endpoint
Cartão de descoberta do agente	GET /.well-known/agent.json
Descoberta MCP	GET /.well-known/mcp
MCP (streamable-http)	https://api.exascale.build/mcp
REST — descobrir	GET /v1/capabilities
REST — schema	GET /v1/power/capacity/schema
REST — consultar	POST /v1/power/capacity/query
REST — evidência	POST /v1/evidence/source-row

Aponte um agente para o cartão de descoberta e ele obtém o mapa completo — endpoints, capacidades e postura de autenticação — em um único GET.

Capacidades

Vinte e cinco pontos de dados ao vivo, mais o composto de fator de capacidade — cada um citado ao seu arquivo de origem e unível onde a fonte fornece âncoras compartilhadas (county_fips, state, balancing_authority_code, eia_plant_id). A lista legível por máquina e sempre atualizada é /v1/capabilities.

Ponto de dados	O que responde
power.capacity	Capacidade de geradores em operação / planejados / aposentados (MW) — EIA-860M	ao vivo
power.asset_ownership	Participações anuais de propriedade de geradores e nomes brutos de proprietários — EIA-860; ausência no cronograma de Proprietários resolve para o padrão de operador da mesma safra	ao vivo
power.generation	Geração líquida (MWh) mais consumo total de combustível e apenas elétrico citado separadamente (MMBtu) por usina, combustível, estado e autoridade de balanceamento, com histórico alinhado de 2014 até o presente — EIA-923	ao vivo
power.fuel_cost	Custos de combustível entregue em nível de recebimento (centavos/MMBtu) e quantidades — EIA-923; custos retidos permanecem como valores ausentes explícitos	ao vivo
power.plant_costs	Capacidade de usina, geração, balanços de usina, despesas com combustível e itens de linha separados de O&M do Formulário 1 da FERC como arquivado; a cobertura da ERCOT é explicitamente parcial	ao vivo
natural_gas.prices	Preços spot diários de Henry Hub ($/MMBtu) e preços médios mensais estaduais de energia elétrica ($/Mcf) — EIA; unidades permanecem separadas e meses de estado indisponíveis permanecem nulos explícitos	ao vivo
power.capacity_factor	O quanto uma frota opera — geração ÷ (capacidade × horas), citado a ambas as fontes (composto)	ao vivo
power.demand	Demanda horária de eletricidade (MW) por autoridade de balanceamento — EIA-930	ao vivo
power.demand_rollup	Demanda horária (MW) para o total nacional US48 + 13 regiões da EIA — EIA-930	ao vivo
power.retail_sales	Vendas anuais de varejo (MWh), receita e clientes por estado e setor — EIA-861	ao vivo
power.price_ercot	Preços de ponto de liquidação do dia seguinte da ERCOT ($/MWh), horários — NP4-190-CD	ao vivo
power.interconnection_queue_*	Projetos de geração solicitando conexão à rede em todos os 7 ISOs/RTOs dos EUA — MISO, PJM, CAISO, NYISO, ISO-NE, ERCOT, SPP (MW solicitados, status, condado; uma solicitação, nunca lida como construída)	ao vivo
ai_infrastructure.construction	Gastos mensais de construção de data centers e fábricas de semicondutores ($M) — Census C30	ao vivo
ai_infrastructure.trade	Importações mensais dos EUA de todos os circuitos integrados (HS-8542) — valor (USD) por país de origem — Census International Trade	ao vivo
ai_infrastructure.equipment_trade	Importações mensais dos EUA de equipamentos para fabricação de chips (HS-8486, incl. máquinas de painéis planos) — valor (USD) por país de origem — a etapa de ferramentas do buildout de fábricas — Census International Trade	ao vivo
ai_infrastructure.production	Índice mensal de produção de semicondutores e componentes eletrônicos (2017=100) e utilização de capacidade (%) — NAICS 3344, histórico até 1972, a etapa de produção de fábricas — Fed G.17	ao vivo
robotics.adoption	Participação de usinas de manufatura dos EUA usando robôs industriais, participação de trabalhadores expostos e capex em robótica — por indústria, estado e tamanho de usina (ASM 2018-2021 + edições do Censo Econômico de 2022, nunca emendadas) — Census Industrial Robotic Equipment	ao vivo
space.satellite_filings	O dossiê de licenciamento de satélites da FCC — cada arquivamento de estação espacial desde os anos 1960 (requerente, tipo de aplicação, status, datas do ciclo de vida), do dump IBFS da FCC (última geração pela FCC em 2026-07-16); a entrada de novos arquivamentos termina na transição ICFS da FCC (~meados de 2025, gravado)	ao vivo
space.satellite_notices	Avisos públicos semanais de satélites do Escritório Espacial da FCC desde a transição ICFS (2025-06-18) — cada aplicação aceita para arquivamento e cada ação tomada (concessões, concessões parciais, rejeições, renúncias), com número de arquivo, indicativo, requerente e datas, como impresso	ao vivo
robotics.trade	Importações mensais dos EUA de robôs industriais (HS-10 8479.50 + 8428.70) — valor aduaneiro (USD) e contagens de robôs por país de origem — Census International Trade	ao vivo
Espaço	Buildout de lançamento / espaçoporto, no mesmo substrato de energia	em implantação

Uma consulta, e o que retorna

curl -X POST https://api.exascale.build/v1/power/capacity/query \
  -H 'content-type: application/json' \
  -d '{"group_by":["state"],"order_by":"nameplate_mw","top_n":3}'

{
  "as_of": "2026-04-01",
  "summary": { "group_count": 51, "totals": { "nameplate_mw": 1392666.4 } },
  "rows": [
    { "group": {"state":"TX"}, "metrics": {"nameplate_mw": 200429.4},
      "lineage": {"citation_ref": "c1"} }
  ],
  "citations": { "c1": { "source_rows_count": 2437,
    "verify": { "source_id":"energy.eia.eia860m", "source_file":"april_generator2026.xlsx",
                "sheet":"Operating", "source_row":26, "raw_file_sha256":"ec15…",
                "as_of":"2026-04-01" } } }
}

Passe esse objeto verify para /v1/evidence/source-row e a resposta inclui "hash_verified": true com os valores literais das linhas — prova, em uma única chamada.

Honestidade por design

Cada ferramenta declara o que não responderá (ex.: capacidade é MW, não geração MWh), para que seu agente recuse perguntas fora do escopo em vez de inventar. Os resultados também trazem notas de escopo sobre armadilhas conhecidas (cumulativo vs. fluxo, escopo regional, medidas assinadas). Os padrões são sensatos (frota operacional atual, somente EUA) e nunca limitam o que você pode alcançar.

Solução de problemas

Erros são projetados para dizer a um agente o que fazer em seguida, não apenas falhar:

• 429 — limite de taxa. Você atingiu um limite de uso justo; a resposta inclui retry_after (segundos). Recue e tente novamente.
• 400 — consulta inválida. O erro nomeia o parâmetro ofensor e os valores permitidos; chame o describe / schema da ferramenta para filtros, agrupamentos e medidas válidos.
• Resultado vazio. Seus filtros não corresponderam a nenhuma linha — amplie-os ou verifique o escopo do ponto de dados em describe. Os padrões são a frota operacional atual, somente EUA.
• Evidência não verifica. Um erro raw_hash_mismatch ou citation_not_served significa que o snapshot foi substituído — reconsulte para o as_of atual e passe o handle verify fresco.
• Conexão / saúde. O endpoint é https://api.exascale.build/mcp (HTTP streamable). 25 consultas gratuitas, depois $49/mês ou $490/ano. As primeiras 10 não precisam de chave; as próximas 15 vêm com uma chave gratuita enviada a um email inserido em exascale.build/free; um as_of passado precisa de uma chave paga (Authorization: Bearer <key>). A demo da página inicial é um limite separado de 10 perguntas por dia. Verificação de saúde: GET https://api.exascale.build/v1/health.

Ainda preso? Envie email para [email protected].

Conecte seu agente → · Termos · Privacidade