Simples Sign — servidor MCP para agentes de IA

Agentes compatíveis com o Model Context Protocol (Claude, Cursor, ChatGPT/Agents SDK, Grok e outros) podem criar envelopes, acompanhar assinaturas, baixar o PDF assinado e a prova pública, validar documentos e analisar contratos. As operações pagas debitam créditos da organização, comprados em reais pelo painel (válidos por 12 meses; falha do serviço estorna).

Endpoint: https://sign.simples.media/api/mcp
Transporte: Streamable HTTP, sem sessão (cada POST traz uma mensagem JSON-RPC; respostas application/json). GET retorna 405 (sem SSE).
Autenticação: Authorization: Bearer sks_... (chave de API da organização, com os escopos das tools que o agente vai usar).
Versões do protocolo: 2025-06-18, 2025-03-26, 2024-11-05.

Configuração

Cliente com suporte a servidores HTTP remotos (ex.: mcp.json):

{
  "mcpServers": {
    "simples-sign": {
      "url": "https://sign.simples.media/api/mcp",
      "headers": { "Authorization": "Bearer ${SIGN_API_KEY}" }
    }
  }
}

Cliente só com stdio — use a ponte mcp-remote:

npx -y mcp-remote https://sign.simples.media/api/mcp --header "Authorization: Bearer $SIGN_API_KEY"

SDK oficial (TypeScript):

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "meu-agente", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://sign.simples.media/api/mcp"), {
  requestInit: { headers: { Authorization: `Bearer ${process.env.SIGN_API_KEY}` } },
}));
console.log(await client.callTool({ name: "get_credits", arguments: {} }));

Tools

Tool	O que faz	Custo	Escopo
`create_envelope`	cria envelope a partir de PDF (base64) e envia os convites	10 créditos	envelopes:write
`get_envelope`	status do envelope e de cada signatário	grátis	envelopes:read
`list_envelopes`	lista envelopes da organização	grátis	envelopes:read
`get_signed_pdf`	URL temporária (15 min) do PDF assinado + SHA-256	grátis	envelopes:read
`get_proof`	prova pública: página /v, JSON, auditoria, OpenTimestamps, Simples Ledger	grátis	envelopes:read
`verify_document`	confere se um PDF/SHA-256 foi assinado no Simples Sign	1 crédito	verify
`analyze_contract`	resumo e cláusulas de risco (IA, informativo)	5 créditos (0 em cache)	ai
`get_credits`	saldo (pago/bônus), validade, preços e como comprar	grátis	credits:read

Erros de negócio voltam como resultado com isError: true e JSON {error, status, ...} (ex.: insufficient_credits, insufficient_scope, not_completed), para o agente poder reagir.

Boas práticas para agentes

Confirme com a pessoa antes de create_envelope: ele envia e-mails reais aos signatários.
Acompanhe pelo webhook (signer.signed, envelope.completed) em vez de consultar em laço; se precisar consultar, no máximo 1 vez por minuto.
A análise por IA não é aconselhamento jurídico; apresente-a assim ao usuário.
Guarde a chave em variável de ambiente/cofre; nunca no prompt. Use uma chave por agente e só os escopos necessários; revogue pela tela da organização.

Compra de créditos

Créditos são comprados em reais (cartão ou Pix) pelo painel; o agente não compra nem transfere créditos. get_credits mostra saldo, validade e lotes. Validade de 12 meses, revalidada a cada compra; consumo FIFO; erro do nosso lado estorna automaticamente.

Simples Media LTDA · Termos · Privacidade