Plith

INÍCIO RÁPIDO

Comece com Plith

Cinco ferramentas para agentes de IA: deduplicação, estimativa de custos, validação de saída, governança comportamental e aprendizado de falhas entre organizações. Escolha seu caminho de integração abaixo.

Obtenha sua chave de API

As chaves são gratuitas — sem formulário de inscrição, sem painel. Apenas uma chamada de API. Ambos os campos são opcionais, mas recomendados.

curl -X POST https://plith.ai/api/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "name": "Your Org"}'

{
  "org_id": "org_abc123",
  "key": "plth_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "prefix": "plth_xxxxxx",
  "message": "Store this key securely — it will not be shown again."
}

⚠A chave é retornada uma vez e não pode ser recuperada novamente — salve-a imediatamente.

• Nível gratuito: 20,000 créditos na inscrição, concedidos após verificar seu e-mail — sem necessidade de cartão.

• Limite de taxa: 3 chaves por IP a cada 24 horas.

Escolha seu caminho

Caminho 1 — Conexão MCP

Um bloco de configuração. Funciona com Claude Desktop, Claude Code e qualquer cliente MCP.

Caminho 2 — API REST

HTTP direto. Funciona com qualquer linguagem ou framework.

Adicione Plith à configuração do seu cliente MCP. Plith expõe 14 ferramentas MCP usando nomenclatura product_action — por exemplo, dedupq_check, burnrate_estimate. Os argumentos são passados diretamente, sem necessidade de aninhamento action/params.

Passo 1 — Obtenha uma chave de API

curl -X POST https://plith.ai/api/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Response — store the key securely, it is shown once 
{
  "org_id": "org_abc123",
  "key": "plth_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "prefix": "plth_xxxxxx",
  "message": "Store this key securely — it will not be shown again."
}

⚠A chave é exibida uma vez e nunca é armazenada em texto simples. Copie-a agora.

Passo 2 — Adicione à configuração do seu cliente MCP

Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json. Para Claude Code, execute claude mcp add ou edite .mcp.json na raiz do seu projeto.

{
  "mcpServers": {
    "plith": {
      "url": "https://plith.ai/api/mcp/rigor",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

✓Reinicie seu cliente MCP. O agente agora tem acesso a 14 ferramentas MCP do Plith: dedupq_check, burnrate_estimate, qualitygate_validate, guardrail_check, pitfalldb_query e mais.

Exemplos de chamadas MCP

O nome da ferramenta usa nomenclatura com sublinhado (por exemplo, dedupq_check); os argumentos são passados diretamente como parâmetros de entrada da ferramenta.

# dedupq_check — check for duplicate tasks
{
  "name": "dedupq_check",
  "arguments": {
    "content": "Summarize the Q3 earnings report",
    "task_id": "task_789"
  }
}

# burnrate_estimate — estimate LLM cost
{
  "name": "burnrate_estimate",
  "arguments": {
    "plan": [
      {"step": 1, "provider": "anthropic", "model": "claude-sonnet-4-6",
       "estimated_input_tokens": 2000, "estimated_output_tokens": 500}
    ]
  }
}

# Legacy: flat names (dedupq, burnrate, etc.) and "plith" umbrella
# still work for backward compatibility
{
  "name": "plith",
  "arguments": { "action": "dedupq.check", "params": { ... } }
}

Autenticação

Envie sua chave de API no cabeçalho x-api-key em cada solicitação. Apenas /api/keys não é autenticado.

curl https://plith.ai/api/dedupq/check \
  -H "x-api-key: plth_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{...}'

Todos os endpoints

Todos os endpoints de produto exigem o cabeçalho x-api-key, exceto /api/keys.

MétodoEndpointCusto

POST

/api/keysCriar organização + chave de API. Corpo: { email?, name? }

GRÁTIS

GET

/api/keys/verifyVerificar se uma chave de API é válida

GRÁTIS

POST

/api/guardrail/policiesCriar uma política de proteção. Corpo: { name, rules }

GRÁTIS

POST

/api/dedupq/checkVerificar tarefas em cache duplicadas ou semanticamente semelhantes.

1 crédito

POST

/api/dedupq/completeMarcar uma tarefa como concluída e armazenar seu resultado no cache de deduplicação.

2 créditos

POST

/api/burnrate/estimateEstimar o custo de LLM para um plano de agente de várias etapas.

1 crédito

POST

/api/burnrate/trackRegistrar o gasto real de LLM para uma tarefa concluída.

GRÁTIS

POST

/api/burnrate/optimizeObter substituições de modelo mais baratas para um plano, dado um orçamento alvo.

1 crédito

GET

/api/burnrate/budgetObter gastos do período atual, orçamento e taxa de consumo.

GRÁTIS

POST

/api/qualitygate/validateValidar a saída do agente em relação às regras de qualidade configuradas.

1-8 / verificação

GET

/api/qualitygate/trendsObter tendências de aprovação/reprovação de validação ao longo do tempo.

GRÁTIS

POST

/api/guardrail/checkVerificar uma ação proposta em relação às políticas comportamentais.

1 crédito

GET

/api/guardrail/policiesListar suas políticas de proteção ativas.

GRÁTIS

POST

/api/pitfalldb/queryConsultar padrões de falha conhecidos para um tipo de tarefa.

2 créditos

POST

/api/pitfalldb/reportRelatar uma nova falha de agente. Contribui para o banco de dados entre organizações.

GRÁTIS

GET

/api/pitfalldb/statsEstatísticas do banco de dados: total de armadilhas, principais tipos de tarefa, adições recentes.

GRÁTIS

GET

/api/billing/balanceObter saldo de créditos e detalhes do plano.

GRÁTIS

POST

/api/billing/checkoutComprar créditos. Valores: 10, 25 ou 100 USD.

GRÁTIS

Grátis: 20,000 créditos na inscrição

Sem necessidade de cartão. Crie uma chave e comece a construir.

Referência completa da APIOpenAPIAutenticação →