Cartorio Certidao MCP Server

MCP (Model Context Protocol) server para gerenciamento de certidoes de cartorio. Permite que IAs solicitem, alterem, concluam e consultem certidoes atraves do protocolo MCP.

Tools disponiveis

Consultas

• listar_tipos_certidao - Lista todos os tipos de certidao cadastrados
• listar_certidoes - Busca e filtra certidoes com paginacao
• detalhar_certidao - Detalhes completos de uma certidao
• estatisticas - Estatisticas gerais do sistema
• listar_tags - Tags disponiveis para certidoes
• listar_formas_pagamento - Formas de pagamento ativas

Acoes

• solicitar_certidao - Cria nova solicitacao de certidao
• alterar_certidao - Altera campos de uma certidao existente
• concluir_certidao - Marca certidao como Entregue
• cancelar_certidao - Cancela uma certidao

Requisitos

• Python 3.10+
• PostgreSQL com banco certidao_db configurado
• Dependencias do sistema de certidoes (Flask, SQLAlchemy, etc.)

Instalacao

pip install cartorio-certidao-mcp

Configuracao

Claude Code / Claude Desktop

Adicione ao seu arquivo de configuracao MCP:

{
  "mcpServers": {
    "certidao": {
      "command": "cartorio-certidao-mcp",
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost/certidao_db"
      }
    }
  }
}

Execucao direta

cartorio-certidao-mcp

Ou via modulo Python:

python -m mcp_server.server

Status flow das certidoes

Solicitado -> Pedido -> Entregue
                |
                v
            Cancelado

• Solicitado: Estado inicial ao criar certidao
• Pedido: Requer numero_pedido e data_pagamento
• Entregue: Requer numero_documento_mobi
• Cancelado: Apenas certidoes "Solicitado" ou "Pedido" podem ser canceladas

Licenca

MIT