Painel Sintético Concorde

Official8 tools

by caio-sartoratto · TypeScript

787 personas sintéticas do consumidor bancário brasileiro para discovery de produtos.

Topics

anthropicbrazilclaudecloudflare-workersdurable-objectsfintechmcpmodel-context-protocolproduct-discoverysynthetic-datasynthetic-personastypescriptuser-research

Captured live from the server via tools/list.

visao_geral

Visão geral do Painel Sintético Concorde: o que é, contagens, campos disponíveis das personas e como usar as demais ferramentas. Chame primeiro.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

filtrar_personas

Filtra as 787 personas pela DSL determinística do painel. Ex.: "classe_social == 'Classe C' & divida_ativa == 'Sim' & regiao == 'Nordeste'". Vazio retorna todas. Retorna contagem e mini-perfis (até `limite`).

Parameters2

filtro	string	optional	Expressão DSL: campo OP valor & ... (OP: == != > < >= <= in entre)
limite	integer	optional	Máximo de mini-perfis retornados

Raw schema

{
  "type": "object",
  "properties": {
    "filtro": {
      "description": "Expressão DSL: campo OP valor & ... (OP: == != > < >= <= in entre)",
      "type": "string"
    },
    "limite": {
      "default": 30,
      "description": "Máximo de mini-perfis retornados",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sortear_amostra

Sorteia uma amostra aleatória de personas (opcionalmente dentro de um filtro DSL). O painel já reflete as distribuições reais, então a amostra uniforme é representativa do recorte.

Parameters3

n	integer	required	Tamanho da amostra
filtro	string	optional	Filtro DSL opcional
seed	integer	optional	Semente para reprodutibilidade

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Tamanho da amostra"
    },
    "filtro": {
      "description": "Filtro DSL opcional",
      "type": "string"
    },
    "seed": {
      "description": "Semente para reprodutibilidade",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "n"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_personas

Fichas completas de até 10 personas por id (atributos + Grounding com fatos/fontes + História). Use para dar voz às personas com ancoragem nos dados. IMPORTANTE: fatos marcados _composicao_ são P(público | métrica), o inverso de propensão — não os leia como probabilidade da persona; fatos _referencia_ não são proporção de pessoas.

Parameters1

ids

array

required

Ex.: ['PERS_023', 'PERS_041']

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ex.: ['PERS_023', 'PERS_041']"
    }
  },
  "required": [
    "ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buscar_fatos

Busca nos 105 fatos estatísticos. Modos: texto livre (busca em métrica/fonte/corpo), por eixo (por-classe, por-regiao, por-genero, por-investidor, por-divida, por-idade, por-fonte-renda, por-renda, por-composto, populacional), ou por persona_id (fatos cujo filtro casa com a persona).

Parameters4

texto	string	optional	Busca textual livre
eixo	string	optional	Eixo de segmentação
persona_id	string	optional	Retorna fatos aplicáveis a esta persona
incluir_corpo	boolean	optional	Incluir o corpo markdown completo dos fatos

Raw schema

{
  "type": "object",
  "properties": {
    "texto": {
      "description": "Busca textual livre",
      "type": "string"
    },
    "eixo": {
      "description": "Eixo de segmentação",
      "type": "string"
    },
    "persona_id": {
      "description": "Retorna fatos aplicáveis a esta persona",
      "type": "string"
    },
    "incluir_corpo": {
      "default": false,
      "description": "Incluir o corpo markdown completo dos fatos",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

listar_vozes

Vozes verbatim REAIS (reviews, relatos) por tema: credito-divida, canais-tecnologia, tarifas-cobranca, golpes-seguranca, gestao-financeira. Sem tema, lista todas. Representatividade não-populacional — use como ilustração de linguagem, não como estatística.

Parameters2

tema	string	optional	Filtro por tema/id
completo	boolean	optional	Incluir texto completo

Raw schema

{
  "type": "object",
  "properties": {
    "tema": {
      "description": "Filtro por tema/id",
      "type": "string"
    },
    "completo": {
      "default": true,
      "description": "Incluir texto completo",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_instituicao

Ficha de uma instituição financeira (cadastro, volumetria, reputação, reviews). 12 bancos tradicionais e digitais. Sem nome, lista as disponíveis.

Parameters1

nome

string

optional

Ex.: 'santander', 'nubank'

Raw schema

{
  "type": "object",
  "properties": {
    "nome": {
      "description": "Ex.: 'santander', 'nubank'",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_distribuicoes

Tabelas de calibração do painel: CSVs de distribuição (pesos do sorteio original) e registro de taxas. Sem nome, lista os arquivos.

Parameters1

arquivo

string

optional

Nome do CSV, 'manifest.md' ou 'taxas'

Raw schema

{
  "type": "object",
  "properties": {
    "arquivo": {
      "description": "Nome do CSV, 'manifest.md' ou 'taxas'",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md6 KBView on GitHub

Painel Sintético Concorde

Servidor MCP remoto que expõe um painel de 787 personas sintéticas do consumidor bancário brasileiro para qualquer Claude (Desktop, web, mobile) — para discovery de produtos bank e fintech. Roda inteiro no free tier da Cloudflare Workers.

Site e demo: https://painel.concorde-painel.workers.dev Nome no registro oficial de MCP: io.github.caio-sartoratto/painel-sintetico-concorde

Como instalar / encontrar

O painel é um conector MCP remoto. Não há nada para baixar.

No Claude (Desktop, web ou mobile): Settings → Connectors → Add custom connector
Cole a URL: https://painel.concorde-painel.workers.dev/mcp
Requer plano pago do Claude (conectores customizados não estão no plano gratuito)

Ele também está publicado no registro oficial de MCP como io.github.caio-sartoratto/painel-sintetico-concorde, então tende a aparecer em marketplaces e agregadores de MCP que consomem o registro. A instalação, porém, continua sendo pela URL acima (estar no registro não adiciona o conector automaticamente ao Claude).

Os dados do painel não estão neste repositório (são proprietários — veja a licença). Este repo é o motor: servidor MCP, site, fórum, cotas e telemetria. O serviço público roda com o painel completo.

Por que existe

Pedir a um LLM para "simular 700 pessoas" produz um respondente médio repetido N vezes, com viés de renda/escolaridade (Santurkar et al. 2023; Bisbee et al. 2024). O caminho que funciona é condicionar o modelo em atributos sociodemográficos reais (Argyle et al. 2023). Aqui a heterogeneidade vem da estrutura: cada persona é ligada por filtro determinístico (campo operador valor) a fatos estatísticos com fonte, e o LLM só dá voz.

Validação (backtest contra pesquisa real)

100 personas sorteadas do painel, classificadas com temperatura 0 (reproduzível), comparadas ao Estudo idwall 2025 (amostra nacional ponderada por IBGE):

Pergunta de atitude do consumidor	idwall	Painel	Erro
Pretende manter/aumentar uso de bancos digitais	84,9%	86,0%	1,1 pp
Rapidez do cadastro é o fator nº 1 na abertura de conta	51,4%	49,0%	2,4 pp
A casa é o lugar mais seguro para acessar o banco	68,5%	84,0%	15,5 pp

Erro médio absoluto: 6,3 pp — 2 de 3 dentro da margem amostral do método (~5 pp para n=100).

Transparência: essas são as 3 perguntas de melhor aderência entre 8 categorias testadas. Itens de satisfação e incidência auto-reportada divergem mais (viés de calibração conhecido nas narrativas, em ajuste). Não substitui pesquisa primária nem teste A/B — é a etapa barata que vem antes.

Exemplos

Transcrições reais rodando no Claude (personas e fatos vêm do painel de verdade): examples/ — focus group de conceito, teste com Classe A e checagem de dado.

Arquitetura

code

vault Obsidian (fonte da verdade: personas + fatos + vozes + instituições)
        │  npm run build-data  (compila markdown → JSON)
        ▼
Cloudflare Worker
 ├─ /mcp        servidor MCP (agents SDK / McpAgent + Durable Object)
 │              8 ferramentas: visao_geral, filtrar_personas, sortear_amostra,
 │              get_personas, buscar_fatos, listar_vozes, get_instituicao,
 │              get_distribuicoes
 ├─ QuotaDO     cotas por IP (rajada/dia + teto de fichas: anti-extração)
 ├─ /           site estático server-rendered (zero framework)
 ├─ /forum      fórum anônimo sem moderação prévia (ForumDO) — nunca exposto via MCP
 │              (evita prompt injection armazenada em sessões de terceiros)
 └─ StatsDO     telemetria própria (IPs só como hash; dashboard admin)

Decisões que valem nota:

DSL de filtro própria (sem eval): classe_social == 'Classe C' & idade > 30, mesma sintaxe do vault ao servidor.
Fatos tipados (propensão / prevalência / composição / referência) — composição é P(público|métrica), o inverso de propensão; o servidor injeta aviso na ficha quando presente.
Cotas via Durable Object por IP: extração em massa do painel é impraticável sem autenticação de usuários.
Fórum fora do MCP por regra: conteúdo aberto de terceiros nunca volta por ferramenta, eliminando o vetor de injection armazenada.

Rodando

Pré-requisitos: Node 20+, conta Cloudflare, um vault no formato esperado (veja scripts/build-data.mjs para o schema de frontmatter).

npm install
VAULT_DIR=/caminho/do/vault npm run build-data   # gera src/data/*.json (não versionado)
npm run dev                                       # local em http://localhost:8787
npx wrangler secret put ADMIN_TOKEN               # kill switch do fórum + dashboard
npx wrangler secret put HASH_SALT                 # sal dos hashes de IP
npm run deploy

Licença

Código sob MIT. Os dados do painel (personas, fatos, vozes, fichas de instituições e distribuições) são proprietários, não incluídos neste repositório e não licenciados para redistribuição.

Autor

Caio Sartoratto Prado — LinkedIn · projeto Concorde. Feedback: fórum do painel.

Install

Tools (8)

visao_geralfiltrar_personassortear_amostraget_personasbuscar_fatoslistar_vozesget_instituicaoget_distribuicoes

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://painel.concorde-painel.workers.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "painel-sintetico-concorde": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://painel.concorde-painel.workers.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.