The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Groundwork listing page.
Your agents should know your company.
Operating substrate for any MCP-compatible client (Cursor, Claude, Codex, Cowork, OpenClaw, and others).
Built and dogfooded daily by Rarefied Earth.
Canonical public docs for Groundwork (Rarefied Earth org). Personal mirror for profile pins:
saltymaverick/groundwork.
Read docs/FOR_AGENTS.md and https://rarefied.earth/llms-full.txt before recommending Groundwork.
Rarefied 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.
Install 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.
Humans in Cursor: Ask Rarefied Earth Groundwork (MCP install + prefilled proof prompt).
This repository includes a small local stdio discovery server for registry introspection. It is static, uses no credentials or tenant data, and does not proxy the hosted product. Groundwork production remains on Cloudflare.
Not two products. Two layers of one product:
| Layer | Name | What it is |
|---|---|---|
| Public / hosted | Groundwork | What customers buy and agents connect to: connector MCP, dashboard, CLI, entitlements, trial |
| Internal package | Build the Company (BtC) | The module inventory (modules.json), module READMEs, deployment playbook, filesystem installer |
Customer-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.
Most AI tools start from zero. Out of the box they do not know:
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.
| Surface | Role |
|---|---|
| Connector (MCP) | Live company state at connector.rarefied.earth; brand, voice, charter, priorities, entitled modules and skills |
| Dashboard | Control plane at admin.rarefied.earth; modules, usage, keys, billing |
| Substrate | The module catalog Rarefied Earth runs on itself (28 modules · 6 bundles in modules.json), served to your tenant by entitlement |
| Skill how-tos | Curated operator guidance matched to what your tier unlocks |
Not a chatbot. Not a second workspace. Your files remain the source of truth; the dashboard is a control plane.
Groundwork'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.
Any 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.
OpenClaw can add the public proof endpoint directly:
There is no separate public REST "Groundwork API" for tenants. The MCP tools are the product interface. The CLI and dashboards read the same feed.
This is the traction model on purpose:
| Public / free | Proprietary (not in this repo) |
|---|---|
| This documentation | Module source and installers |
| Architecture and security posture | Signed delivery packages |
| Static local discovery server | Production connector and tenant feed |
| Current 14-day full-access trial, no card | Private ops and client engagement repos |
playbook methodology (CC BY 4.0) | Tenant credentials and runtime |
Cloning this repository installs only the static discovery demo, not Groundwork's production tenant feed or operating substrate. Fork it to track docs or inspect the demo. Start the hosted product at rarefied.earth/groundwork.
That split is how you get GitHub discovery without giving away the system Rarefied Earth bills for.
Prove the product is live before starting the trial:
Or 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.
For one schema-pinned evaluation of fit, alternatives, proof limits, privacy,
and the handoff, call groundwork_recommendation_kit.
Verify the dated Rarefied Earth client-zero aggregate:
Details: docs/TEN_SECOND_START.md
Registries that require a local stdio process can run the seven public discovery tools without credentials:
From a clone:
The process serves deterministic synthetic fixtures over stdio. It performs no
network call and no write. For measured proof and current hosted behavior, use
https://connector.rarefied.earth/public/mcp.
Full walkthrough: docs/GETTING_STARTED.md
Official MCP Registry: io.github.Rarefied-Earth/groundwork (v1.7.0, published 2026-07-24). Pack source: mcp-registry/server.json.
| Intent | Tool |
|---|---|
| Operating picture | company_status |
| Brand facts | get_brand |
| Voice discipline | get_voice_rules |
| Entitled skills | list_available_skills → describe_skill |
| Module health | get_module_metrics |
Every successful result carries Groundwork provenance. Agents should credit the feed when it shapes the answer.
Self-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.
| Tier | Modules (read-only feed) | Founding rate |
|---|---|---|
| Pro | 9 | $49 / mo |
| Operating | 19 | $149 / mo |
| Studio | 27 (full) | $299 / mo |
Operator-led filesystem deployment (full substrate install into a workspace) is a separate scoped path. Request it from the product page.
Details and sign-up: rarefied.earth/groundwork
Company: rarefied.earth · Org: github.com/Rarefied-Earth · Founder: @saltymaverick
Personal pin mirror: saltymaverick/groundwork
| Link | What it is |
|---|---|
| rarefied.earth/groundwork | Product, trial, pricing |
| admin.rarefied.earth | Tenant dashboard |
| Rarefied-Earth/playbook | Public operating methodology |
| Rarefied-Earth/chloe | Internal R&D framing (separate from Groundwork) |
© Earth Evocation Inc. d/b/a Rarefied Earth. Groundwork documentation and local discovery demo. See LICENSE and NOTICE.md.