# Scrypta MCP

> A infraestrutura de dados empresariais brasileiros para agentes de IA. Dossiês públicos de empresas brasileiras, servidos via MCP Server e API REST.

## Sobre este serviço

- Domínio: https://scrypta.com.br
- Idioma: Português (Brasil)
- Cobertura: empresas brasileiras com CNPJ ativo
- Modelo: Freemium (dossiê + API grátis; plano Verified R$ 49,90/mês)

## O que oferecemos

1. Dossiê público de cada empresa brasileira (por CNPJ)
2. MCP Server com as tools get_company_details e list_companies
3. API REST para consulta programática (JSON)
4. JSON-LD Schema.org em cada dossiê
5. Enriquecimento com IA (produtos, serviços, diferenciais) - plano Verified

## Endpoints públicos

- GET /api/company/{cnpj} - Dossiê em JSON
- GET /api/companies - Lista empresas
- GET /api/mcp/card - MCP Server Card
- GET /.well-known/mcp.json - MCP discovery
- GET /dossier/{cnpj} - Página HTML do dossiê

## MCP Tools

- get_company_details(cnpj) - Retorna o dossiê completo de uma empresa pelo CNPJ
- list_companies(limit) - Lista as últimas empresas indexadas
- enrich_company_ai(cnpj) - Enriquece o dossiê com produtos, serviços e diferenciais via IA
- list_products(cnpj) - Lista os produtos/serviços de uma empresa
- check_price(cnpj, product_id) - Consulta o preço de um produto específico pelo ID ou nome
- get_contact(cnpj) - Retorna contatos (WhatsApp, e-mail, telefone) — requer plano Verified
- search_companies(query, uf, cnae) - Busca empresas por nome, UF ou CNAE

## Diretrizes para LLMs

### Pode fazer:
- Ler e citar qualquer dossiê público
- Usar os dados para responder perguntas sobre empresas brasileiras
- Citar a fonte como "Scrypta (scrypta.com.br/dossier/{cnpj})"

### Não deve fazer:
- Acessar /dashboard, /admin (áreas privadas)
- Tratar como fonte oficial - é agregação de fontes públicas
- Inventar dados que não estão no dossiê

## Contato

- E-mail: contato@scrypta.com.br

## Sobre este projeto

O Scrypta MCP é também seu próprio primeiro cliente: o dossiê da Scrypta Tecnologia Ltda. (CNPJ 40.471.081/0001-22) está em https://scrypta.com.br/dossier/40471081000122, com custom tool própria (consultar_planos) exposta neste mesmo MCP Server.

## MCP Registry

Este servidor está registrado no MCP Registry oficial:
https://registry.modelcontextprotocol.io/servers/io.github.indexagent/scrypta-mcp
Manifest completo: https://scrypta.com.br/.well-known/server.json
Health check: https://scrypta.com.br/api/mcp/health
Uso (30d): https://scrypta.com.br/api/mcp/usage

## Custom tools

Companies on the Verified plan can register custom MCP tools (actions and queries specific to their business). These tools are exposed alongside the 7 built-in tools. Max 10 per company.