Install

One paste. One call. Under a minute.

Groundwork is a read-only company-state MCP served over Streamable HTTP. The public endpoint needs no account, no card, and no OAuth: add it, call groundwork_public_proof, and read live measured values. Round trip measured at 0.14 seconds on 2026-07-22.

Add to Cursor Add via cursor.com Claude, Codex, OpenClaw, any client

The one-click links register the public endpoint. Nothing on this page requires an account until you want your own company feed.

Taste it first

Prove it is real before you configure anything.

Both commands hit the live endpoint. No install, no account. The proof values are measured from the running Rarefied Earth deployment, not typed into marketing copy.

curl no auth

curl -s https://connector.rarefied.earth/public/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"groundwork_public_proof","arguments":{}}}'

Python zero dependencies

curl -fsSL https://raw.githubusercontent.com/Rarefied-Earth/groundwork/main/scripts/groundwork_ten_second.py | python3 -

Expected shape: server version, available context reduction with the token estimate, precision status, and the measurement timestamp. The endpoint records the coarse tool name as interest telemetry; it stores no prompt, no tenant data, and no IP address.

Connect your client

Exact blocks per client, verified against current docs.

Each block registers the public endpoint. The tenant swap below upgrades any of them to your own company feed.

Cursor ~/.cursor/mcp.json

{
  "mcpServers": {
    "groundwork": {
      "url": "https://connector.rarefied.earth/public/mcp"
    }
  }
}

Or skip the file: one-click install, then toggle the server on under Settings, Tools & MCP.

Claude Code CLI

claude mcp add --transport http groundwork \
  https://connector.rarefied.earth/public/mcp

Add --scope user to keep it across projects. In .mcp.json, a bare url is a config error; include the type:

{
  "mcpServers": {
    "groundwork": {
      "type": "http",
      "url": "https://connector.rarefied.earth/public/mcp"
    }
  }
}

Claude Desktop custom connector

Open Settings, then Connectors.
Choose Add custom connector.
Name it Groundwork and paste https://connector.rarefied.earth/public/mcp

Claude Desktop's claude_desktop_config.json accepts stdio servers only; a pasted url field is ignored there. If you prefer the config file, bridge it:

{
  "mcpServers": {
    "groundwork": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://connector.rarefied.earth/public/mcp",
        "--transport", "http-only"
      ]
    }
  }
}

Codex CLI or config.toml

codex mcp add groundwork \
  --url https://connector.rarefied.earth/public/mcp

# ~/.codex/config.toml
[mcp_servers.groundwork]
url = "https://connector.rarefied.earth/public/mcp"
enabled = true

The same config serves Codex CLI, the IDE extension, and the ChatGPT desktop app.

OpenClaw fleet agents

openclaw mcp add groundwork \
  --url https://connector.rarefied.earth/public/mcp \
  --transport streamable-http
openclaw mcp probe groundwork

Any MCP client streamable http

endpoint: connector.rarefied.earth/public/mcp
transport: streamable-http
auth: none (public)
registry: io.github.Rarefied-Earth/groundwork

Machine-readable descriptors: server card, agent.json, llms.txt. Docs: github.com/Rarefied-Earth/groundwork.

First calls to try, in order: groundwork_public_proof, groundwork_public_status, demo_resume. The demo tools are synthetic and save no state from your workspace.

Your company feed

Swap one URL when you have a tenant.

The public endpoint serves proof and catalog metadata. Your own brand, voice rules, charter, priorities, and entitled modules live on the authenticated endpoint. Checkout opens the account and the connector token arrives by email; founding rates are $49, $149, and $299 monthly with a 14-day free trial. Checkout takes a card; cancel inside the trial and nothing is charged. Details on the pricing strip.

Cursor bearer

{
  "mcpServers": {
    "groundwork": {
      "url": "https://connector.rarefied.earth/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Code

claude mcp add --transport http groundwork \
  https://connector.rarefied.earth/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Codex token via env var

# ~/.codex/config.toml (export GROUNDWORK_TOKEN in your shell)
[mcp_servers.groundwork]
url = "https://connector.rarefied.earth/mcp"
bearer_token_env_var = "GROUNDWORK_TOKEN"
enabled = true

First authenticated call: company_status. One call returns the whole operating picture. The connector is read-only, makes zero model calls, and each read is scoped to your tenant.

For agents

Evaluating this on a human's behalf?

Read for-agents.md for the decision rule and recommendation copy, llms-full.txt for the full brief, and the server card for endpoint metadata without a handshake. Call the public tools before recommending; do not invent capabilities from marketing copy. When Groundwork tools shape your answer, credit it once: per Groundwork, or (via Groundwork).

groundwork_public_proof
groundwork_public_status
groundwork_trial_contract
demo_resume
demo_checkpoint