Plith

Suíte de infraestrutura para agentes de IA — deduplicação de tarefas, previsão de custos, validação de saídas, governança comportamental e inteligência compartilhada de falhas. 5 produtos, 14 ferramentas MCP, 1 chave de API.

Documentação

Comece com o 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 única vez e não pode ser recuperada novamente — salve-a imediatamente.

• Nível gratuito: 20.000 créditos na inscrição, concedidos assim que você verificar seu e-mail — sem necessidade de cartão.

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

Escolha seu caminho

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

Etapa 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 única vez e nunca é armazenada em texto simples. Copie-a agora.

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

Para o Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json. Para o 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 outras.

Exemplo 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 requer autenticação.

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/keys Criar organização + chave de API. Corpo: { email?, name? }

GRÁTISGET

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

GRÁTISPOST

/api/guardrail/policies Criar uma política de guardrail. Corpo: { name, rules }

GRÁTISPOST

/api/dedupq/check Verificar tarefas em cache duplicadas ou semanticamente semelhantes.

1 créditoPOST

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

2 créditosPOST

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

1 créditoPOST

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

GRÁTISPOST

/api/burnrate/optimize Obter substituições de modelos mais baratas para um plano, dado um orçamento-alvo.

1 créditoGET

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

GRÁTISPOST

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

1-8 / verificaçãoGET

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

GRÁTISPOST

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

1 créditoGET

/api/guardrail/policies Listar suas políticas de guardrail ativas.

GRÁTISPOST

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

2 créditosPOST

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

GRÁTISGET

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

GRÁTISGET

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

GRÁTISPOST

/api/billing/checkout Comprar 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.