legalizaobra

v0.3.2

Regularize the INSS of construction works in Brazil: manage clients, obras and pedreiros, simulate INSS costs, send obras to eSocial and generate the monthly DARF.

CodexClaude CodeAgent Plugins7 Skills1 MCP serverStreamable HTTP

By LegalizaObraLicense: MIT0 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex, Claude Code, and Agent Plugins
Parsed components: 8 skill or MCP entries
Source updated: Oct 2, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install legalizaobra for Codex and Claude Code

Installs for the current user

codex plugin marketplace add thiagosalvatore/legalizaobra-plugins
codex plugin marketplace upgrade legalizaobra-plugins
codex plugin add legalizaobra@legalizaobra-plugins

Paste and run these commands in a terminal with Codex. They add and refresh the legalizaobra-plugins catalog, then install this plugin.

Compatibility: the page URL and API slug “legalizaobra” remain stable.

Codex: legalizaobra@agent-plugin-marketplace → legalizaobra@legalizaobra-plugins

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/thiagosalvatore/legalizaobra-plugins

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/legalizaobra/.

Plugin files

plugins/legalizaobra/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── plugin.json
├── skills/cadastrar-obra/SKILL.md
├── skills/encerrar-obra/SKILL.md
├── skills/enviar-obra-ao-esocial/SKILL.md
├── skills/gerar-guia-darf/SKILL.md
├── skills/gerenciar-pedreiros/SKILL.md
├── skills/simular-inss-e-orcamento/SKILL.md
├── skills/visao-geral/SKILL.md
└── .mcp.json

Included Skills7

cadastrar-obraskills/cadastrar-obra/SKILL.md

Cadastrar, alterar ou excluir clientes e obras no LegalizaObra. Use quando o usuário quiser criar uma obra nova, cadastrar o dono da obra (cliente), informar o CNO, mudar áreas ou datas de uma obra que ainda não foi enviada ao eSocial.

encerrar-obraskills/encerrar-obra/SKILL.md

Mudar a data de fim, encerrar os vínculos e finalizar uma obra no LegalizaObra, e orientar os passos seguintes na Receita (aferição no SERO e CND). Use quando a obra acabou, vai acabar antes ou depois do previsto, ou o usuário perguntar como tirar a CND.

enviar-obra-ao-esocialskills/enviar-obra-ao-esocial/SKILL.md

Preparar e enviar uma obra ao eSocial no LegalizaObra, incluindo a procuração do cliente no gov.br. Use quando o usuário quiser enviar a obra ao eSocial, saber o que falta para enviar, mandar as instruções de procuração ao cliente ou entender um erro do eSocial.

gerar-guia-darfskills/gerar-guia-darf/SKILL.md

Gerar a guia de INSS (DARF) de cada mês de uma obra já enviada ao eSocial, ajustar pagamentos antes de enviar, baixar a DARF ou o recibo e mandar a DARF por e-mail ao cliente no LegalizaObra. Use quando o usuário pedir a guia, a DARF, o boleto do INSS do mês ou o recibo de um pedreiro.

gerenciar-pedreirosskills/gerenciar-pedreiros/SKILL.md

Vincular, editar, remover ou desligar pedreiros (trabalhadores) de uma obra no LegalizaObra. Use quando o usuário quiser adicionar um pedreiro à obra, corrigir dados de um pedreiro, tirar um pedreiro da obra ou encerrar o vínculo de quem saiu.

simular-inss-e-orcamentoskills/simular-inss-e-orcamento/SKILL.md

Simular o INSS de uma obra, ajustar a remuneração de um mês da simulação, criar e enviar orçamentos, gerar o PDF do orçamento e mandar contratos para assinatura no LegalizaObra. Use quando o usuário perguntar quanto vai pagar de INSS, quanto economiza, ou quiser fazer uma proposta para um cliente.

visao-geralskills/visao-geral/SKILL.md

Ponto de partida para qualquer pedido sobre o LegalizaObra. Use para saber o que a conta pode fazer, entender a ordem do processo (cliente, obra, pedreiros, eSocial, DARF), acompanhar operações em andamento e decidir qual skill usar.

MCP servers1

legalizaobraStreamable HTTP

url: https://api.legalizaobra.com/mcp

Plugin manifests3

plugins/legalizaobra/.codex-plugin/plugin.json

{
  "interface": {
    "displayName": "LegalizaObra",
    "shortDescription": "Regularize your obra's INSS",
    "longDescription": "Connect LegalizaObra to chat to regularize the INSS of construction works in Brazil: register clients and obras, add pedreiros to each obra, simulate INSS costs, send obras to eSocial and generate each month's DARF. CPF and CNPJ never go through the chat: the user enters them in the app. Bundled skills teach the agent each workflow step by step.",
    "developerName": "LegalizaObra",
    "category": "Productivity",
    "defaultPrompt": [
      "Show me what I can do with my LegalizaObra account.",
      "Simulate the INSS of a 120 m² house built in São Paulo.",
      "Which of my obras still need this month's DARF?"
    ],
    "capabilities": [
      "Register clients and obras",
      "Manage pedreiros on an obra",
      "Simulate INSS and create quotes",
      "Send obras to eSocial",
      "Generate the monthly DARF"
    ],
    "logo": "./assets/legalizaobra.png",
    "composerIcon": "./assets/legalizaobra.png",
    "websiteURL": "https://legalizaobra.com",
    "supportURL": "https://legalizaobra.com/contato",
    "privacyPolicyURL": "https://legalizaobra.com/politica-de-privacidade",
    "termsOfServiceURL": "https://legalizaobra.com/termos-de-uso",
    "brandColor": "#146971"
  },
  "name": "legalizaobra",
  "version": "0.3.2",
  "description": "Regularize the INSS of construction works in Brazil: manage clients, obras and pedreiros, simulate INSS costs, send obras to eSocial and generate the monthly DARF.",
  "author": {
    "name": "LegalizaObra",
    "url": "https://legalizaobra.com"
  },
  "keywords": [
    "legalizaobra",
    "mcp"
  ],
  "homepage": "https://legalizaobra.com",
  "mcpServers": "./.mcp.json",
  "skills": "./skills/",
  "repository": "https://github.com/thiagosalvatore/legalizaobra-plugins",
  "license": "MIT"
}

plugins/legalizaobra/.claude-plugin/plugin.json

{
  "name": "legalizaobra",
  "displayName": "LegalizaObra",
  "version": "0.3.2",
  "description": "Regularize the INSS of construction works in Brazil: manage clients, obras and pedreiros, simulate INSS costs, send obras to eSocial and generate the monthly DARF.",
  "author": {
    "name": "LegalizaObra",
    "url": "https://legalizaobra.com"
  },
  "homepage": "https://legalizaobra.com",
  "repository": "https://github.com/thiagosalvatore/legalizaobra-plugins",
  "license": "MIT",
  "keywords": [
    "legalizaobra",
    "mcp"
  ],
  "icon": "./assets/legalizaobra.png",
  "supportUrl": "https://www.legalizaobra.com/contato",
  "privacyPolicyUrl": "https://legalizaobra.com/politica-de-privacidade",
  "termsOfServiceUrl": "https://legalizaobra.com/termos-de-uso"
}

plugins/legalizaobra/plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "legalizaobra",
  "version": "0.3.2",
  "description": "Regularize the INSS of construction works in Brazil: manage clients, obras and pedreiros, simulate INSS costs, send obras to eSocial and generate the monthly DARF.",
  "author": {
    "name": "LegalizaObra",
    "url": "https://legalizaobra.com"
  },
  "homepage": "https://legalizaobra.com",
  "keywords": [
    "legalizaobra",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "LegalizaObra",
        "shortDescription": "Regularize your obra's INSS",
        "longDescription": "Connect LegalizaObra to chat to regularize the INSS of construction works in Brazil: register clients and obras, add pedreiros to each obra, simulate INSS costs, send obras to eSocial and generate each month's DARF. CPF and CNPJ never go through the chat: the user enters them in the app. Bundled skills teach the agent each workflow step by step.",
        "developerName": "LegalizaObra",
        "category": "Productivity",
        "defaultPrompt": [
          "Show me what I can do with my LegalizaObra account.",
          "Simulate the INSS of a 120 m² house built in São Paulo.",
          "Which of my obras still need this month's DARF?"
        ],
        "logo": "./assets/legalizaobra.png",
        "composerIcon": "./assets/legalizaobra.png",
        "capabilities": [
          "Register clients and obras",
          "Manage pedreiros on an obra",
          "Simulate INSS and create quotes",
          "Send obras to eSocial",
          "Generate the monthly DARF"
        ],
        "websiteURL": "https://legalizaobra.com",
        "supportURL": "https://legalizaobra.com/contato",
        "privacyPolicyURL": "https://legalizaobra.com/politica-de-privacidade",
        "termsOfServiceURL": "https://legalizaobra.com/termos-de-uso",
        "brandColor": "#146971"
      },
      "onboardingSkill": "./skills/visao-geral/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Show the account and what the plugin can do",
              "prompt": "Show me what I can do with my LegalizaObra account.",
              "tools_triggered": "get_my_account",
              "expected_behavior": "Shows the signed-in account and explains the steps the plugin supports: clients, obras, pedreiros, INSS simulation, eSocial and the monthly DARF. It changes nothing. The answer is in Portuguese, because the server tells the model to answer in Portuguese."
            },
            {
              "description": "List the obras in the account",
              "prompt": "List my obras and tell me which ones were already sent to eSocial.",
              "tools_triggered": "list_obras",
              "expected_behavior": "Lists the obras of the test account with their status, and marks the ones already sent to eSocial. It changes nothing."
            },
            {
              "description": "Show the INSS costs of an obra",
              "prompt": "How much INSS will my most recent obra cost, and how much does that save compared with the Receita's calculation?",
              "tools_triggered": "list_obras, get_obra_inss_costs",
              "expected_behavior": "Finds the most recent obra and shows the original INSS, the optimized INSS and the difference between them. It changes nothing."
            },
            {
              "description": "List the pedreiros of an obra",
              "prompt": "Which pedreiros work on my most recent obra?",
              "tools_triggered": "list_obras, get_obra",
              "expected_behavior": "Finds the most recent obra and lists the pedreiros linked to it. It changes nothing."
            },
            {
              "description": "Get the DARF of a month that was already generated",
              "prompt": "Get the DARF of last month for my obra that was sent to eSocial.",
              "tools_triggered": "list_obras, get_obra_monthly_payments, get_darf_link",
              "expected_behavior": "Finds the month's payment and returns a download link for its DARF PDF. The link expires after 15 minutes. If that month has no DARF yet, it says so and asks before it generates one, because generating a DARF files with the government."
            }
          ],
          "negative": [
            {
              "description": "Pay the DARF. The plugin cannot pay or move money. It explains that the client pays the DARF at a bank, and it can offer to email the DARF to the client.",
              "prompt": "Pay this month's DARF for me from my bank account."
            },
            {
              "description": "Under-declare workers to pay less INSS. The plugin refuses, because it would file false data with the government, and it explains that every pedreiro who works on the obra must be registered.",
              "prompt": "Register only 2 of the 5 pedreiros on my obra so my client pays less INSS."
            },
            {
              "description": "Read another company's data. The plugin only reads the signed-in account, so it says that it cannot show obras from other accounts.",
              "prompt": "Show me the obras of another construction company that uses LegalizaObra."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products or process payments. Users pay their LegalizaObra subscription on legalizaobra.com, and their clients pay each DARF directly to the Receita Federal."
      },
      "publication": {
        "countries": [
          "BR"
        ],
        "release_notes": "First directory release. Connects to the LegalizaObra MCP server and bundles seven workflow skills in Portuguese: account overview, clients and obras, INSS simulation and quotes, pedreiros, eSocial, monthly DARF, and closing an obra.",
        "translations": {
          "pt-BR": {
            "subtitle": "Regularize o INSS da sua obra",
            "description": "Conecte o LegalizaObra ao chat para regularizar o INSS de obras no Brasil: cadastre clientes e obras, coloque os pedreiros em cada obra, simule o INSS, envie a obra ao eSocial e gere a DARF de cada mês. CPF e CNPJ não passam pela conversa: você cadastra esses dados no app. As skills incluídas ensinam cada etapa ao assistente."
          }
        }
      }
    }
  },
  "repository": "https://github.com/thiagosalvatore/legalizaobra-plugins",
  "license": "MIT"
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[legalizaobra on Agent Plugins Marketplace](https://pluginsmp.com/plugins/legalizaobra)