Reciba

npx add-mcp 'https://reciba.com.br/mcp'

Seu agente prepara. Seu usuário emite.

O Reciba tem uma API aberta para agentes de IA (ChatGPT, Claude, Gemini e afins) prepararem documentos de serviço a pedido de um humano: o agente preenche o rascunho com os dados da conversa e entrega o link; o usuário revisa a prévia completa e emite — 3 documentos grátis pra testar, depois R$ 1 no Pix, com a logo dele e sem cadastro.

Por que o agente não emite sozinho?

Porque o valor do documento está na cadeia de confiança: assinatura eletrônica com e-mail confirmado, registro com data/hora e IP, e QR de verificação pública, na forma do art. 10, §2º, da MP 2.200-2/2001. Essa cadeia começa num ato humano — e é exatamente isso que faz o documento valer alguma coisa quando chega na outra parte. Emissão automática em massa destruiria o que o seu usuário está comprando.

Endpoints

• GET /api/agent — doc viva em JSON (política + tipos).
• GET /api/agent/openapi.json — OpenAPI 3.1, um POST /api/agent/draft/{tipo} por tipo, com o schema de campos derivado do próprio motor.
• POST /api/agent/draft/{tipo} — cria o rascunho e devolve editarUrl (entregue ao usuário; o link é a credencial dele).
• GET /api/agent/verificar/{codigo} — verificação de autenticidade pelo código do QR/link: emissão registrada, e-mail confirmado, aceite da contraparte. Aberta, sem chave.

Conector MCP

O mesmo princípio vale no conector MCP do Reciba, em https://reciba.com.br/mcp (Streamable HTTP, sem login), para ChatGPT, Claude e outros apps compatíveis: o assistente prepara o rascunho com os dados da conversa e entrega um link que abre uma vez só; a pessoa confere a prévia e emite no site, pela conta dela, com o e-mail confirmado.

• list_document_types: os tipos que o conector prepara (recibo de pagamento, recibo de aluguel, orçamento de serviço e ordem de serviço) e os campos de cada um.
• prepare_document: cria o rascunho e devolve o link de uso único para a pessoa conferir e emitir.
• verify_document: confere a autenticidade de um documento emitido no Reciba pelo código do QR.
• amount_in_words: escreve um valor em reais por extenso, como sai nos recibos.

O conector não emite, não cobra e não manda nada; não aceita CPF, CNPJ nem RG (a pessoa completa no site); não faz nota fiscal, nem recibo que outra pessoa tem de emitir (como o do dentista para o imposto de renda), nem diz quanto cobrar. Declarações, recibo de salário e os outros tipos a pessoa faz direto no site. Cartão do servidor: /mcp/server-card.

Os 23 tipos de documento

• Orçamento de serviço (orcamento) — Serviços e materiais discriminados, total automático e validade. O clássico de quem fecha serviço.
• Ordem de serviço (ordem-servico) — Número automático, serviço descrito, peças e data agendada. Organiza o trabalho no papel.
• Ordem de serviço (os-oficina) — Placa, km, peça e mão de obra separadas; o cliente aprova pelo link antes do serviço.
• Ordem de serviço (os-celular) — IMEI, estado do aparelho e orçamento aprovado no celular do cliente.
• Ordem de serviço (os-informatica) — Número de série, defeito e backup autorizado, com a aprovação registrada.
• Ordem de serviço (os-ar-condicionado) — Equipamento, BTUs, gás e garantia do serviço num documento só.
• Ordem de serviço (os-eletrica-hidraulica) — Serviço na casa do cliente com orçamento aprovado e garantia por escrito.
• Orçamento complementar (orcamento-complementar) — Achou mais coisa? O extra vai para o cliente aprovar antes de você mexer.
• Termo de retirada (termo-retirada) — O cliente confirma pelo link que retirou o carro ou o aparelho. A garantia conta dessa data.
• Recibo de pagamento (recibo-pagamento) — Quem pagou, quanto e por quê — com o valor por extenso saindo sozinho.
• Recibo de prestação de serviço (recibo-prestacao) — O recibo de quem prestou serviço: descrição do que foi feito + valor por extenso.
• Recibo de aluguel (recibo-aluguel) — Mês de referência, encargos discriminados e valor por extenso. Todo dia 5, pronto.
• Proposta comercial (proposta) — Apresentação, escopo em blocos, investimento e próximos passos. Fecha negócio.
• Fatura simples (fatura) — A cobrança organizada: itens, total, vencimento e a chave Pix no papel.
• Recibo de salário (recibo-salario) — O pagamento do mês, preto no branco: valor, competência e a assinatura de quem recebeu.
• Vale (vale) — Adiantou dinheiro? O vale registra quanto, pra quem e de onde desconta.
• Comprovante de vale-transporte (vale-transporte) — A entrega do vale-transporte do mês, com valor, competência e assinatura.
• Romaneio de entrega (romaneio) — A lista da entrega: o que vai, quanto vai e quem confere no destino.
• Declaração de residência (declaracao-residencia) — Comprove seu endereço na hora: autodeclaração na forma da Lei 7.115/83, verificável pelo QR.
• Declaração de união estável (declaracao-uniao-estavel) — Vocês dois declaram a convivência — pra plano de saúde, dependente e cadastros.
• Declaração de renda (declaracao-renda) — Autônomo declara a própria renda — pra aluguel, cadastro e crédito simples.
• Nota promissória (nota-promissoria) — A promessa de pagamento com data marcada — o título clássico, pronto pra imprimir e assinar.
• Contrato de prestação de serviços (contrato-prestacao) — O combinado por escrito: objeto, valor, prazo e garantia — com aceite registrado.

Regras da casa

• Rascunho é grátis e sem chave — o mesmo poder do wizard público, com rate limit por IP.
• Nenhum e-mail é enviado pelo fluxo de agente; nenhuma cobrança acontece via API.
• O editarUrl é a credencial do documento: entregue só ao usuário atendido.
• Rascunhos abandonados são podados; documento emitido tem link permanente.

Descoberta: /llms.txt. Dúvidas ou volume maior: acesso@reciba.com.br.