Skip to main content
Glama

comptext-mcp

comptext-mcp is the planned MCP contract layer for exposing deterministic local ctxt --json results to MCP clients.

Phase 0 is documentation-only. This repository baseline does not implement an MCP server, package runtime, provider integration, token passthrough, proposal application, network access, external-agent invocation, or general shell access. Pre-existing runtime and package files may be present in the repository, but they are outside Phase 0 scope and are not treated as release-ready behavior by this documentation baseline.

Core principle:

Models are providers. Context is the product.

Architecture Position

  • ctxt is the deterministic source of truth.

  • ctxt owns behavior, schemas, validation, and deterministic context.

  • comptext-mcp must not invent behavior.

  • comptext-mcp is a future adapter only.

  • Future MCP tools must map one-to-one to stable local ctxt --json commands.

  • Runtime artifacts and proposal artifacts are untrusted evidence, not workspace truth.

Related MCP server: densely

Phase 0 Scope

Phase 0 creates the documentation and contract baseline only:

  • PROJEKT.md

  • README.md

  • .gitignore

  • SECURITY.md

  • docs/ARCHITECTURE.md

  • docs/CONTRACTS.md

  • docs/ROADMAP.md

No runtime code, package scaffolding, server implementation, generated reports, hooks, plugins, dependencies, provider calls, proposal application, or general shell access are part of Phase 0.

Review Tool Policy

@github, @codex-security, and @openai-developers may be used only as review and context tools for Phase 0 documentation. They do not grant permission to create runtime code, call providers, enable network behavior, create server implementation, add token passthrough, create hooks or plugins, invoke external agents, apply proposals, or write git history.

Subagents, if used, are limited to deterministic review and planning over Phase 0 docs, security boundaries, tool mappings, and consistency.

Trusted Future Command Surface

Future MCP tools may only wrap these stable local commands:

ctxt --json self report
ctxt --json schema
ctxt --json capabilities
ctxt --json proposals list
ctxt --json proposals inspect latest --max-bytes 12000
ctxt --json proposals inspect --id latest --max-bytes 12000
ctxt --json proposals validate latest
ctxt --json proposals validate --id latest
ctxt --json validate --run
ctxt --json agent discover
ctxt --json runs list
ctxt --json runs read latest --max-bytes 12000

Unsupported ctxt commands are not part of the Phase 0 MCP contract.

Documentation

Available Tools

7 tools
comptext_contract_checkC

Check local safety contracts for OpenCode usage.

Inputs: no named parameters. Returns: object

comptext_github_packA

Prepare a local GitHub summary pack without network calls.

Inputs: no named parameters. Returns: object

comptext_hf_export_packA

Return Hugging Face Space/Card export text without upload or token usage.

Inputs: no named parameters. Returns: object

comptext_pack_contextC

Create a deterministic context pack with stable file order and sha256 hashes.

Inputs: max_bytes. Returns: object

comptext_replay_digestC

Create a deterministic replay/evidence digest for the current workspace.

Inputs: max_bytes. Returns: object

comptext_rust_auditC

Run safe read-only Rust checks.

Inputs: check, clippy, tests_no_run. Returns: object

comptext_statusB

Return CompText, Rust, Cargo, Git, and workspace status.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: contract checking, GitHub packaging, Hugging Face export, context packing, replay digest, Rust audit, and status. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent 'comptext_' prefix followed by descriptive snake_case names (e.g., comptext_contract_check, comptext_status). The pattern is uniform and predictable.

    Tool Count5/5

    With 7 tools, the count is well within the ideal range (3-15). Each tool serves a clear function without excess or deficiency for the server's apparent scope.

    Completeness4/5

    The tools cover core workflows: contract checks, exports, context packing, digests, audits, and status. Minor gaps might exist (e.g., no tool for clearing or resetting state), but the set is largely complete for typical usage.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A local, evidence-driven MCP runtime and control plane for open-source maintainers that provides workspace-bounded tools including controlled file operations, command execution, validation primitives, durable execution records, and human review workflows via stdio and Streamable HTTP transports.
      33
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Lossless context compression for LLMs, packing text into 2x-8x fewer tokens with byte-exact reconstruction. Provides MCP tools to compress files/text and expand exact slices, verified by sha256.
      54 PyPI
      8
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Zero-dependency stdio bridge to Moltline Studio's fleet of 14 hosted MCP servers covering code review, time operations, data transforms, business ops, education, research, outreach and more. Free tier requires no registration; premium tools unlock with a license. Independently audited, MCPize Verified A.
      10
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Turn any folder or Git repo into safe, token-efficient context for LLMs, AI chats, and coding agents like Claude Code, Codex, and Cursor — local-first GUI, TUI, CLI, and a read-only MCP server with Live Context, agent journal, Smart Ignore, secret/PII redaction, Git scopes, and code compression. Windows, macOS, Linux.
      8
      41
      Apache 2.0