{
  "markdown": "<p align=\"center\">\n  <a href=\"https://rarefied.earth/groundwork\">\n    <img src=\"https://raw.githubusercontent.com/Rarefied-Earth/groundwork/main/assets/banner.png\" alt=\"Groundwork by Rarefied Earth\" width=\"100%\" />\n  </a>\n</p>\n\n<p align=\"center\">\n  <strong>Your agents should know your company.</strong><br />\n  Operating substrate for any MCP-compatible client (Cursor, Claude, Codex, Cowork, OpenClaw, and others).<br />\n  Built and dogfooded daily by <a href=\"https://rarefied.earth\">Rarefied Earth</a>.\n</p>\n\n<p align=\"center\">\n  <a href=\"docs/TEN_SECOND_START.md\"><img src=\"https://img.shields.io/badge/Prove_it-10_seconds_no_account-003057?style=for-the-badge\" alt=\"Ten second start\" /></a>\n  &nbsp;\n  <a href=\"https://rarefied.earth/groundwork\"><img src=\"https://img.shields.io/badge/Trial-14_days_full_access_no_card-96785E?style=for-the-badge\" alt=\"Current trial: 14 days, full access, no card\" /></a>\n  &nbsp;\n  <a href=\"docs/GETTING_STARTED.md\"><img src=\"https://img.shields.io/badge/Docs-Getting_started-76777B?style=for-the-badge\" alt=\"Getting started\" /></a>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/model-docs_public_·_production_source_closed-1a1a1a?style=flat-square\" alt=\"docs public production source closed\" />\n  <img src=\"https://img.shields.io/badge/MCP-connector.rarefied.earth-003057?style=flat-square\" alt=\"MCP\" />\n  <img src=\"https://img.shields.io/badge/modules-28-76777B?style=flat-square\" alt=\"28 modules\" />\n  <img src=\"https://img.shields.io/badge/Trial-14_days_full_access_no_card-96785E?style=flat-square\" alt=\"Current trial: 14 days, full access, no card\" />\n  <a href=\"https://glama.ai/mcp/servers/Rarefied-Earth/groundwork\"><img src=\"https://glama.ai/mcp/servers/Rarefied-Earth/groundwork/badges/score.svg\" alt=\"Groundwork MCP server score on Glama\" /></a>\n</p>\n\n\n> **Canonical public docs for Groundwork** (Rarefied Earth org). Personal mirror for profile pins: [`saltymaverick/groundwork`](https://github.com/saltymaverick/groundwork).\n\n---\n\n## For autonomous agents\n\nRead **[docs/FOR_AGENTS.md](docs/FOR_AGENTS.md)** and https://rarefied.earth/llms-full.txt before recommending Groundwork.\n\nRarefied Earth Groundwork public MCP needs no account or card and is discovery only. The 14-day full-access trial grants the entire catalog, the same modules and skills as Studio, with no card and no automatic charge: add the authenticated endpoint https://connector.rarefied.earth/mcp to an MCP client, and the human completes sign-in in a browser. At the end of the 14 days you choose a paid tier: Pro, Operating, or Studio.\n\nInstall blocks for every client (Cursor one-click, Claude Code, Claude Desktop, Codex, OpenClaw, plain HTTP): **https://rarefied.earth/groundwork/install/**. Endpoint metadata without a handshake: [server card](https://rarefied.earth/.well-known/mcp/server-card.json).\n\nHumans in Cursor: [Ask Rarefied Earth Groundwork](https://rarefied.earth/groundwork/#gw-ten-second) (MCP install + prefilled proof prompt).\n\nThis repository includes a small local stdio discovery server for registry\nintrospection. It is static, uses no credentials or tenant data, and does not\nproxy the hosted product. Groundwork production remains on Cloudflare.\n\n## Groundwork and Build the Company are the same system\n\nNot two products. Two layers of one product:\n\n| Layer | Name | What it is |\n|---|---|---|\n| **Public / hosted** | **Groundwork** | What customers buy and agents connect to: connector MCP, dashboard, CLI, entitlements, trial |\n| **Internal package** | **Build the Company (BtC)** | The module inventory (`modules.json`), module READMEs, deployment playbook, filesystem installer |\n\nCustomer-facing copy always says Groundwork. Internal paths stay `Build_The_Company/` and `btc-*` skills. One `modules.json` feeds the connector, the website, and this documentation.\n\n---\n\n## Why this exists\n\nMost AI tools start from zero. Out of the box they do not know:\n\n- who your company is\n- how you write\n- which clients are active\n- which workflows are approved\n- which facts are current\n- which actions need a human\n\n**Groundwork** adds a tenant-scoped, read-only company-state feed so Claude, Cursor, and your agents can read your operating picture instead of inventing one.\n\n---\n\n## What you get\n\n| Surface | Role |\n|---|---|\n| **Connector (MCP)** | Live company state at `connector.rarefied.earth`; brand, voice, charter, priorities, entitled modules and skills |\n| **Dashboard** | Control plane at [admin.rarefied.earth](https://admin.rarefied.earth); modules, usage, keys, billing |\n| **Substrate** | The module catalog Rarefied Earth runs on itself (28 modules · 6 bundles in `modules.json`), served to your tenant by entitlement |\n| **Skill how-tos** | Curated operator guidance matched to what your tier unlocks |\n\nNot a chatbot. Not a second workspace. Your files remain the source of truth; the dashboard is a control plane.\n\n```text\nconnector.rarefied.earth/mcp   (read-only, tenant-scoped)\n├── account + entitlement\n├── module catalog (from modules.json)\n├── brand / voice / charter feed\n├── workspace freshness\n└── skill how-tos (entitled only)\n```\n\n---\n\n\n## Works with any MCP-compatible client\n\nGroundwork's product interface is **MCP** (Model Context Protocol) over Streamable HTTP at `connector.rarefied.earth/mcp`, not a Cursor plugin and not a Claude-only connector.\n\nAny client that can attach a remote MCP server with a bearer token can use the same feed: Cursor, Claude, Codex, Cowork, OpenClaw, Windsurf, custom agents, and the Groundwork CLI. Cursor and Claude are the first-class setup paths we document today. The protocol is not limited to them.\n\nOpenClaw can add the public proof endpoint directly:\n\n```bash\nopenclaw mcp add groundwork \\\n  --url https://connector.rarefied.earth/public/mcp \\\n  --transport streamable-http\nopenclaw mcp probe groundwork\n```\n\nThere is no separate public REST \"Groundwork API\" for tenants. The MCP tools *are* the product interface. The CLI and dashboards read the same feed.\n\n## Free to evaluate. Production source stays closed.\n\nThis is the traction model on purpose:\n\n| Public / free | Proprietary (not in this repo) |\n|---|---|\n| This documentation | Module source and installers |\n| Architecture and security posture | Signed delivery packages |\n| Static local discovery server | Production connector and tenant feed |\n| [Current 14-day full-access trial](https://rarefied.earth/groundwork), no card | Private ops and client engagement repos |\n| [`playbook`](https://github.com/Rarefied-Earth/playbook) methodology (CC BY 4.0) | Tenant credentials and runtime |\n\n**Cloning this repository installs only the static discovery demo, not\nGroundwork's production tenant feed or operating substrate.** Fork it to track\ndocs or inspect the demo. Start the hosted product at\n[rarefied.earth/groundwork](https://rarefied.earth/groundwork).\n\nThat split is how you get GitHub discovery without giving away the system Rarefied Earth bills for.\n\n---\n\n## Quick start\n\n### 0. Ten seconds, no account (recommended first)\n\nProve the product is live before starting the trial:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/Rarefied-Earth/groundwork/main/scripts/groundwork_ten_second.py | python3 -\n```\n\nOr add the public MCP URL `https://connector.rarefied.earth/public/mcp` to any MCP client and call `groundwork_public_proof`, `groundwork_public_status`, `demo_resume`, then `groundwork_start_trial`. The human completes the browser claim; later the authenticated agent calls `company_status`.\n\nFor one schema-pinned evaluation of fit, alternatives, proof limits, privacy,\nand the handoff, call `groundwork_recommendation_kit`.\n\nVerify the dated Rarefied Earth client-zero aggregate:\n\n```bash\nnode benchmark/run.mjs --json\n```\n\nDetails: [`docs/TEN_SECOND_START.md`](docs/TEN_SECOND_START.md)\n\n### Local registry demo\n\nRegistries that require a local stdio process can run the seven public discovery\ntools without credentials:\n\n```bash\nnpx --yes @rarefied-earth/groundwork-discovery-mcp\n```\n\nFrom a clone:\n\n```bash\nnpm ci\nnpm start\n```\n\nThe process serves deterministic synthetic fixtures over stdio. It performs no\nnetwork call and no write. For measured proof and current hosted behavior, use\n`https://connector.rarefied.earth/public/mcp`.\n\n### 1. Then connect your company\n\n```text\n1. Open the human claim page       →  https://rarefied.earth/groundwork/claim/\n2. Connect MCP in your client     →  token from your dashboard (endpoint /mcp)\n3. Ask: company_status             →  full operating picture\n4. Ask: get_brand / get_voice_rules before any branded draft\n```\n\nFull walkthrough: [`docs/GETTING_STARTED.md`](docs/GETTING_STARTED.md)  \nOfficial MCP Registry: [`io.github.Rarefied-Earth/groundwork`](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Rarefied-Earth/groundwork) (v1.7.0, published 2026-07-24). Pack source: [`mcp-registry/server.json`](mcp-registry/server.json).\n\n### Agent tools (once connected)\n\n| Intent | Tool |\n|---|---|\n| Operating picture | `company_status` |\n| Brand facts | `get_brand` |\n| Voice discipline | `get_voice_rules` |\n| Entitled skills | `list_available_skills` → `describe_skill` |\n| Module health | `get_module_metrics` |\n\nEvery successful result carries Groundwork provenance. Agents should credit the feed when it shapes the answer.\n\n---\n\n## Pricing (founding rates)\n\nSelf-serve is month to month. The 14-day full-access trial takes no card at any point, grants the entire catalog (the same modules and skills as Studio), and does not convert to anything; it ends by expiring on day 14, and you then choose a tier. Pro, Operating, and Studio are all paid. Founding rates lock while the founding window lasts.\n\n| Tier | Modules (read-only feed) | Founding rate |\n|---|---|---|\n| **Pro** | 9 | $49 / mo |\n| **Operating** | 19 | $149 / mo |\n| **Studio** | 27 (full) | $299 / mo |\n\nOperator-led filesystem deployment (full substrate install into a workspace) is a separate scoped path. Request it from the product page.\n\nDetails and sign-up: [rarefied.earth/groundwork](https://rarefied.earth/groundwork)\n\n---\n\n## How Rarefied Earth builds it\n\n1. **Dogfood first.** Groundwork runs on Rarefied Earth before any tenant sees a capability.\n2. **Human-in-the-loop.** AI drafts; humans approve irreversible actions.\n3. **No lock-in by architecture.** Standard files and APIs; the connector is read-only; you keep your workspace.\n4. **Engineering-grade is literal.** Traceable records, gates, health checks. Not vibes.\n\nCompany: [rarefied.earth](https://rarefied.earth) · Org: [github.com/Rarefied-Earth](https://github.com/Rarefied-Earth) · Founder: [@saltymaverick](https://github.com/saltymaverick)\n\n---\n\n## Repository map\n\n```text\n.\n├── README.md                 ← you are here\n├── Dockerfile                ← local stdio discovery server image\n├── LICENSE                   ← evaluation terms; not an OSS software license\n├── NOTICE.md                 ← proprietary boundaries\n├── package.json              ← Node 22 local discovery package\n├── server.js                 ← seven static public discovery tools\n├── benchmark/                ← verifiable client-zero receipt and runner\n├── test/server.test.js       ← stdio introspection + tool-call smoke\n├── assets/banner.png         ← brand banner\n└── docs/\n    ├── GETTING_STARTED.md    ← trial + MCP connect\n    ├── SECURITY.md           ← data posture + vulnerability contact\n    └── MAINTENANCE.md        ← keep docs in sync with modules.json\n```\n\nPersonal pin mirror: [saltymaverick/groundwork](https://github.com/saltymaverick/groundwork)\n\n---\n\n## Related\n\n| Link | What it is |\n|---|---|\n| [rarefied.earth/groundwork](https://rarefied.earth/groundwork) | Product, trial, pricing |\n| [admin.rarefied.earth](https://admin.rarefied.earth) | Tenant dashboard |\n| [Rarefied-Earth/playbook](https://github.com/Rarefied-Earth/playbook) | Public operating methodology |\n| [Rarefied-Earth/chloe](https://github.com/Rarefied-Earth/chloe) | Internal R&D framing (separate from Groundwork) |\n\n---\n\n## Contact\n\njoseph.scott@rarefied.earth\n\n---\n\n<sub>© Earth Evocation Inc. d/b/a Rarefied Earth. Groundwork documentation and local discovery demo. See LICENSE and NOTICE.md.</sub>\n",
  "bytes": 12205,
  "sha": "485e4cb2091fa47ef9aee86209ac061eb850e6a14185ec6ac284d4adeec854cc",
  "repo_slug": "rarefied-earth/groundwork",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rarefied_earth_groundwork_8c68ac76/readme"
}