Strale

Camada de confiança para agentes de IA — mais de 233 capacidades de dados verificadas com pontuações de qualidade em tempo real, trilhas de auditoria e suporte à conformidade. Pesquise, inspecione e execute via MCP.

GitHub

Documentação

Strale

Infraestrutura de confiança e qualidade para agentes de IA.

O que é Strale

Strale é um marketplace de capacidades para agentes de IA. Agentes chamam strale.do() em tempo de execução para acessar capacidades verificadas — consultas a registros empresariais, verificações de conformidade, validação financeira, segurança Web3 e muito mais — além de soluções agrupadas para fluxos de trabalho em várias etapas, como uma verificação KYB completa ou due diligence de empresas, em vez de o próprio código do agente integrar e gerenciar credenciais para cada fonte de dados de que possa precisar.

Toda capacidade é monitorada: capacidades do nível gratuito são testadas contra fontes reais em uma programação, capacidades pagas são monitoradas por meio de observabilidade de produção e um piso de qualidade imposto, e toda chamada retorna um resultado estruturado e auditável com procedência da fonte. O catálogo atual, a lista do nível gratuito e a cobertura por país são valores dinâmicos, não números impressos aqui — veja Como usar abaixo para saber onde lê-los.

Como usar

Servidor MCP (recomendado: sem instalação)

{
  "mcpServers": {
    "strale": {
      "type": "streamableHttp",
      "url": "https://api.strale.io/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente MCP com suporte a Streamable HTTP. Para stdio local ou a superfície completa de ferramentas, veja packages/mcp-server/README.md.

SDK TypeScript

npm install straleio

import Strale from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY });
const result = await strale.do("eu-vat-validate", { vat_number: "SE556000000001" });

Referência completa: packages/sdk-typescript/README.md.

SDK Python

pip install straleio

from straleio import Strale

strale = Strale(api_key="your_api_key")
result = strale.do("eu-vat-validate", {"vat_number": "SE556000000001"})

Referência completa: packages/sdk-python/README.md.

Comece sem uma chave de API

Um subconjunto de capacidades (validação de e-mail/IBAN/endereço de criptomoeda, consulta DNS, reparo de JSON, URL para markdown e mais) funciona sem cadastro, sem chave de API e sem carteira — apenas com um limite diário de taxa baseado em IP. Leia a lista atual em GET /v1/platform/facts (free_tier_slugs), não em um número neste arquivo. Obtenha uma chave e créditos de teste em strale.dev quando precisar do restante do catálogo.

Integrações com frameworks

Pacote	Registro	Descrição
`strale-mcp`	npm	Servidor MCP — o catálogo completo de capacidades via Claude, Cursor, qualquer host MCP
`straleio`	npm	SDK TypeScript/JavaScript
`straleio`	PyPI	SDK Python
`langchain-strale`	PyPI	Toolkit LangChain (`StraleToolkit`)
`crewai-strale`	PyPI	Integração CrewAI — BaseTools plug-and-play para agentes
`strale-semantic-kernel`	npm	Plugin Semantic Kernel para agentes .NET e TypeScript
`composio-strale`	PyPI	Integração Composio — ações personalizadas

O README de cada pacote é a referência para aquela integração; este arquivo apenas aponta para eles. Cada PR de distribuição contra um repositório de framework externo, e cada publicação de um desses pacotes, segue o Protocolo de Integridade de PR de Distribuição do CLAUDE.md — um pacote que afirma integração nativa com framework é verificado contra o artefato publicado, não a árvore de código-fonte, antes de a alegação ser publicada.

Web3

Capacidades Web3 (pontuação de risco de carteira, detecção de honeypot de token, resolução ENS, dados de protocolos DeFi, oráculo de gás, verificação VASP da MiCA da UE, sentimento de mercado) e soluções agrupadas para agentes on-chain estão disponíveis via protocolo de pagamento x402 — pague por chamada com USDC na mainnet Base, sem cadastro. Nem toda capacidade é elegível para x402; leia o subconjunto dinâmico e atualizado em:

GET https://api.strale.io/x402/catalog
GET https://api.strale.io/.well-known/x402.json

Qualidade

As capacidades são testadas continuamente contra suas fontes reais: verificações de resposta conhecida, esquema, negativa, caso extremo e saúde de dependência, além de verificações complementares alimentadas por tráfego real de produção quando o modelo de custo de uma capacidade inviabiliza testes proativos. Um piso de qualidade imposto coloca em quarentena uma capacidade que caia abaixo dele no tráfego real e a promove de volta automaticamente na recuperação. Strale deliberadamente não publica uma única pontuação numérica composta de qualidade — uma anterior foi aposentada porque comprimia modos de falha não relacionados em um número que parecia mais preciso do que era. O que é exposto em vez disso é a evidência bruta por capacidade: status, timestamp do último teste, histórico recente de testes, limitações conhecidas e a fonte de dados por trás dela.

GET https://api.strale.io/v1/capabilities/vat-validate

Toda capacidade publica suas limitações honestamente, incluindo lacunas de cobertura. Metodologia: strale.dev/quality.

Regras de IDE para manipulação segura de dados

Adicione estes arquivos ao seu projeto para dar ao seu agente de codificação orientação de segurança para dados sensíveis à confiança (IBANs, registros empresariais, sanções, PII):

Cursor: docs/ide-rules/strale-compliance.mdc → .cursor/rules/
Windsurf: docs/ide-rules/strale-compliance.windsurfrules → raiz do projeto, ou .windsurf/rules/ como .md
Claude Code: o trecho em docs/claude-md-snippet.md → CLAUDE.md do seu projeto

Estes previnem as vulnerabilidades mais comuns de codificação por vibração: validação de IBAN no lado do cliente, chaves de API codificadas, metadados de procedência ausentes e raspagem direta de registros.

Habilidades de Agente e exemplos de código

Habilidades de Agente — arquivos SKILL.md para Claude Code, Cursor, Copilot e Codex. Copie skills/strale/ para .claude/skills/, .github/skills/ ou .cursor/skills/.
Verifique uma empresa com Strale (Python)
Valide IBANs — grátis, sem chave de API (Python)
Construa um agente com Strale (TypeScript)
Conecte Strale ao Claude (guia de configuração)

Mais

strale.dev — página inicial e cadastro
strale.dev/docs — referência da API
strale.dev/pricing — preços
scan.strale.io — Beacon, um scanner gratuito de prontidão para agentes
api.strale.io/mcp — endpoint MCP (Streamable HTTP)
Exemplos — exemplos de copiar e colar para cada integração

Como o código está organizado

strale/
├── apps/api/          Hono API server: routes, capability executors,
│                       Drizzle schema + queries, Stripe/matching/auth
│                       helpers. drizzle/ holds the migration history.
├── packages/           Published SDKs and framework integrations (see the
│                       table above) plus internal workspace packages.
├── manifests/          One YAML file per live capability: pricing, data
│                       source, field-reliability declarations, test
│                       fixtures. The onboarding pipeline
│                       (apps/api/scripts/onboard.ts) is the only
│                       sanctioned way a capability enters the system —
│                       see CLAUDE.md's Capability Onboarding Protocol.
├── design/             Design tokens as data (colors, type, spacing) —
│                       one active file per surface, candidates carry a
│                       status, promotion is a decision plus a file swap.
├── config/              Cross-cutting configuration as data, e.g. the
│                       environment-variable manifest every process.env
│                       read is registered against.
└── scripts/            Repo-root tooling: the checkers behind every
                        `npm run *:check` script, the session-handoff
                        gate, and one-off operator scripts.

apps/api/scripts/ e apps/api/src/capabilities/ carregam a mesma ideia no escopo de autoria de capacidades — leia a seção "Adding New Capabilities" de CLAUDE.md antes de escrever um novo executor.

Como a empresa administra o repositório

Onde a verdade mora. A verdade sobre produto, estado e roadmap está migrando do Notion para este repositório (docs/project/), mas a migração não está completa: docs/project/START-HERE.md e o restante de docs/project/ são explicitamente candidatos (authority_active: false) até uma transição confirmada pelos fundadores. Até lá, o Notion (Project Home, o To-do & Build Plan, o Decisions DB) é a fonte autoritativa, e CLAUDE.md / AGENTS.md dizem isso no topo de cada sessão. docs/README.md indexa cada subárvore docs/ com seu status de autoridade atual; docs/project/STRUCTURE.md registra exatamente onde o layout do repositório ainda diverge do alvo da migração e por quê.

Onde o trabalho em andamento mora. Trabalho em vários lotes é rastreado em docs/programs/ (comece em docs/programs/README.md): cada programa tem um PROGRAM.md com uma seção "Resume here" e um tracks.yaml verificado por máquina. Uma sessão que retoma um programa lê apenas esses dois arquivos e segue seus ponteiros — o histórico de chat nunca é necessário.

Como as sessões funcionam. CLAUDE.md é o manual operacional canônico para sessões do Claude Code; AGENTS.md é seu derivado condensado para sessões do Codex-CLI e aponta de volta para CLAUDE.md para qualquer coisa que possa divergir, em vez de reafirmá-la. Toda sessão termina por meio de um portão de handoff (scripts/handoff/handoff-check.mjs, instalado como um hook de git) que se recusa a deixar uma sessão sair com trabalho não commitado, um branch não enviado, uma worktree desatualizada ou mudanças de código sem uma superfície de retomada para a próxima sessão. O trabalho em lotes acontece em um git worktree isolado, nunca no checkout compartilhado principal — veja WORKTREES.md.

O que o CI verifica, por categoria, não por lista exaustiva (veja .github/workflows/ci.yml para o conjunto exato e atual): uma trilha de integração com Postgres efêmero para comportamento crítico da cadeia de dinheiro e auditoria; typecheck e lint em apps/api e em todos os pacotes publicados; portões estruturais de manifesto de capacidade e consistência de fixtures; integridade de pacotes de framework (um pacote *-strale publicado deve conter código real do framework com o qual afirma integrar); uma família de registros de conteúdo-como-dados, cada um com seu próprio verificador e índice gerado — pesquisa (docs/research/), tokens de design (design/), o manifesto de variáveis de ambiente (config/), o registro de IDs de modelo, o registro de alegações públicas (docs/company/claims.yaml), registros de trilhas de programa (docs/programs/*/tracks.yaml) e a própria estrutura docs/ deste repositório (docs:check, archive:index -- --check); e o portão de handoff de sessão em si. Cada um desses verificadores planta um caso de falha em uma fixture descartável e prova que falha antes da correção — veja a família docs/company/LESSONS.md F5.

Onde a história mora

archive/ contém material encerrado, histórico e substituído — veja archive/README.md para saber o que cada subárvore contém, gerado (com prosa escrita à mão acima) por npm run archive:index. handoff/ contém um arquivo por registro de fim de sessão; handoff/README.md é um índice gerado, em ordem cronológica reversa, de todos eles por data e intenção declarada. Nenhum dos dois diretórios é leitura obrigatória para retomar o trabalho — o registro de programas e docs/project/START-HERE.md são.

Licença

MIT