Docs

Começo
rápido.

Chave em um minuto, primeira chamada em curl, JavaScript e Python, e o DataX dentro do Claude Code, do Claude Desktop e do Cursor.

1. Chave em um minuto

Crie a conta em /conta: informe o e-mail e entre pelo link que chega nele (sem senha). Não pede cartão: a cota gratuita do mês vem junto. Criar a conta é aceitar os termos (/termos) e a política de privacidade (/privacidade).
A chave aparece no painel na hora. Guarde-a: ela identifica a sua conta, a cota gratuita do mês (3.000 operações no lançamento, 1.000 depois), o limite de 60 operações por minuto e o saldo de créditos pré-pagos.
Envie a chave em toda chamada no cabeçalho X-Api-Key (a rota MCP também aceita Authorization: Bearer).
No plano Aberto a atribuição "Fonte: DataX PIRANOT", com link, é obrigatória em toda publicação.

2. Primeira chamada

curl -H "X-Api-Key: SUA_CHAVE" https://www.piranot.com.br/datax/api/v1/catalog
curl -H "X-Api-Key: SUA_CHAVE" https://www.piranot.com.br/datax/api/v1/loterias/megasena
curl -H "X-Api-Key: SUA_CHAVE" "https://www.piranot.com.br/datax/api/v1/eleicoes/secoes/sp/piracicaba"

const r = await fetch('https://www.piranot.com.br/datax/api/v1/indicadores', { headers: { 'X-Api-Key': 'SUA_CHAVE' } });
const dados = await r.json();
console.log(dados.indicadores.map(i => [i.id, i.points.at(-1)]));

import requests
r = requests.get('https://www.piranot.com.br/datax/api/v1/precos', headers={'X-Api-Key': 'SUA_CHAVE'}, timeout=30)
r.raise_for_status()
for g in r.json()['grupos']:
    print(g['name'], g['observations'][-1])

Toda resposta traz fonte, source_url, last_updated e, nos datasets com ressalvas, o campo ressalvas. Os cabeçalhos de resposta informam o uso da cota do mês, o restante e o saldo de créditos. Erro 401 = chave ausente ou inválida; 429 = limite por minuto; 402 = cota do mês esgotada e sem créditos (a resposta traz o link de recarga em /conta/recarga); 404 = dado inexistente; 503 = dataset indisponível neste ambiente.

3. Conectar no Claude Code

claude mcp add --transport http datax https://www.piranot.com.br/datax/mcp --header "X-Api-Key: SUA_CHAVE"
# depois, dentro do Claude Code:
# "use a ferramenta consultar do datax para o dataset credito-imobiliario"

4. Conectar no Claude Desktop

Em Configurações → Conectores → Adicionar conector personalizado, informe a URL do servidor e, em cabeçalhos, X-Api-Key com a sua chave. Alternativa por arquivo (claude_desktop_config.json), usando a ponte mcp-remote:

{
  "mcpServers": {
    "datax": {
      "command": "npx",
      "args": ["mcp-remote", "https://www.piranot.com.br/datax/mcp", "--header", "X-Api-Key:SUA_CHAVE"]
    }
  }
}

5. Conectar no Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "datax": { "url": "https://www.piranot.com.br/datax/mcp", "headers": { "X-Api-Key": "SUA_CHAVE" } }
  }
}

Ferramentas do MCP

Ferramenta	O que faz	Parâmetros
catalogo	Lista os datasets com cobertura, fonte, licença e last_updated.	nenhum
consultar	Qualquer dataset do catálogo, com a mesma leitura, os mesmos parâmetros e o mesmo envelope (fonte, source_url, licença, last_updated, qualidade, aviso) da rota /api/v1 dele. Cada dataset, com seus parâmetros e um exemplo, está em /api/docs#mcp-consultar e na descrição da ferramenta (tools/list).	dataset (id do catálogo, obrigatório), parametros (objeto), recurso (só onde há mais de um)
serie	Séries do estado: selic, dolar, ipca, ipca-grupos, loteria (modalidade, concurso), eleicoes (uf, municipio).	tipo (obrigatório), grupo, desde, modalidade, concurso, uf, municipio
verificar	Confere um número citado contra o estado (selic, dolar, ipca, ipca-grupo:<código>) e responde confere, diverge ou sem_dado, com a fonte.	indicador, periodo, valor, tolerancia

Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.

Começorápido.