decompose-mcp

Decompose

Decompose any text or URL into classified semantic units. Each unit gets authority level, risk category, attention score, entity extraction, and irreducibility flags. No LLM required. Deterministic. Runs locally.

Setup

1. Install

pip install decompose-mcp

2. Configure MCP Server

Add to your OpenClaw MCP config:

{
  "mcpServers": {
    "decompose": {
      "command": "python3",
      "args": ["-m", "decompose", "--serve"]
    }
  }
}

3. Verify

python3 -m decompose --text "The contractor shall provide all materials per ASTM C150-20."

Available Tools

decompose_text

Decompose any text into classified semantic units.

Parameters:

• text (required) — The text to decompose
• compact (optional, default: false) — Omit zero-value fields for smaller output
• chunk_size (optional, default: 2000) — Max characters per unit

Example prompt: "Decompose this spec and tell me which sections are mandatory"

Returns: JSON with units array. Each unit contains:

• authority — mandatory, prohibitive, directive, permissive, conditional, informational
• risk — safety_critical, security, compliance, financial, contractual, advisory, informational
• attention — 0.0 to 10.0 priority score
• actionable — whether someone needs to act on this
• irreducible — whether content must be preserved verbatim
• entities — referenced standards and codes (ASTM, ASCE, IBC, OSHA, etc.)
• dates — extracted date references
• financial — extracted dollar amounts and percentages
• heading_path — document structure hierarchy

decompose_url

Fetch a URL and decompose its content. Handles HTML, Markdown, and plain text.

Parameters:

• url (required) — URL to fetch and decompose
• compact (optional, default: false) — Omit zero-value fields

Example prompt: "Decompose https://spec.example.com/transport and show me the security requirements"

What It Detects

• Authority levels — RFC 2119 keywords: "shall" = mandatory, "should" = directive, "may" = permissive
• Risk categories — safety-critical, security, compliance, financial, contractual
• Attention scoring — authority weight x risk multiplier, 0-10 scale
• Standards references — ASTM, ASCE, IBC, OSHA, ACI, AISC, AWS, ISO, EN
• Financial values — dollar amounts, percentages, retainage, liquidated damages
• Dates — deadlines, milestones, notice periods
• Irreducibility — legal mandates, threshold values, formulas that cannot be paraphrased