Get started with Basalt

teambasaltv1productguide

Get started with Basalt

Basalt is the trust layer for AI-generated work. Your agents write markdown; Basalt turns it into branded, permissioned, versioned pages your company can actually rely on. Agents create. Basalt governs. Humans decide. Companies remember.

The 60-second path. Connect your AI once, ask it to publish a doc, and you have a live, access-controlled URL. No editor to learn, no copy-paste — your agent does the writing, Basalt does the governing.

1. Connect your AI

Basalt is driven from any MCP-capable AI (Claude, Claude Code, Cursor). You log in once via Cofoundy SSO and your agent inherits exactly your access — your vaults, your grants, nothing more.

→ Connect Basalt to your AI (MCP) — one command for Claude Code, one URL for Claude.

claude mcp add --transport http --scope user basalt https://app.basalt.cofoundy.ai/api/mcp

2. Publish your first doc

Once connected, just ask your agent in natural language:

  • "publish this as a doc on Basalt" → it compiles, lints, and returns a live URL
  • "pull doc X so I can edit it" → round-trip: edit → republish
  • "share doc X with my team / make it public" → access is a grant, set per-doc
Markdown in, trusted truth out. Every publish auto-compiles + lints — broken or unsafe content is rejected with a clear error. For data-shaped content (KPIs, comparisons, callouts) your agent emits MDX components, not hand-styled markdown.

3. Govern it

What makes Basalt different from a docs site:

  • Per-document RBAC — a doc you can't read is indistinguishable from one that doesn't exist. Make one file public à la "anyone with the link" while the rest of the vault stays team-only.
  • Versioned — every publish is an immutable artifact by content hash; history is retained.
  • Agent round-trip — your agent proposes a change as a reviewable diff, a human accepts or rejects, the agent reads the verdict over MCP and republishes. The source stays markdown the whole time.

Where to go next

  • Connect your AI — the activation step.
  • Ask your agent: "list my docs on Basalt" or "search Basalt for X".
  • It's dogfood all the way down: this very page was published to Basalt, by an agent, over MCP.