diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 41f0c9a9..0477a6f7 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -25,9 +25,9 @@ jobs:
node-version: "22"
- name: Setup pnpm
- uses: pnpm/action-setup@v2
+ uses: pnpm/action-setup@v4
with:
- version: 9
+ version: 11.3.0
run_install: false
- name: Get pnpm store directory
diff --git a/web/docs/docs/Agents/_category_.json b/web/docs/docs/Agents/_category_.json
index faa07ade..373ca825 100644
--- a/web/docs/docs/Agents/_category_.json
+++ b/web/docs/docs/Agents/_category_.json
@@ -1,6 +1,6 @@
{
"label": "Marmot for Agents",
- "position": 5,
+ "position": 2,
"link": {
"type": "doc",
"id": "Agents/index"
diff --git a/web/docs/docs/Agents/index.md b/web/docs/docs/Agents/index.md
index 84bbd0a5..a3d06d5f 100644
--- a/web/docs/docs/Agents/index.md
+++ b/web/docs/docs/Agents/index.md
@@ -4,10 +4,52 @@ sidebar_position: 1
# Marmot for Agents
-**Marmot for Agents** plugs your LLM agents into the catalog. They read it for context and write back the lineage they generate.
+An agent acting without context is guessing. It doesn't know which table holds customer orders, who owns the payments service, what a column means, or what breaks downstream if it changes something. **Marmot for Agents** ends that context starvation: it plugs your LLM agents into the catalog so they read it for context and write back the lineage they generate.
import { CalloutCard, DocCard, DocCardGrid, FeatureCard, FeatureGrid } from '@site/src/components/DocCard';
+## What your agents can do
+
+
+
+
+
+
+
+
+## Two ways to connect
+
+
+
+
+
+
## Supported frameworks
diff --git a/web/docs/docs/MCP/index.md b/web/docs/docs/MCP/index.md
index 87428dc9..1d3d8f68 100644
--- a/web/docs/docs/MCP/index.md
+++ b/web/docs/docs/MCP/index.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 6
+sidebar_position: 3
---
# Model Context Protocol (MCP)
diff --git a/web/docs/docs/introduction.md b/web/docs/docs/introduction.md
index 14274ed1..0b0d0f0f 100644
--- a/web/docs/docs/introduction.md
+++ b/web/docs/docs/introduction.md
@@ -4,7 +4,9 @@ sidebar_position: 1
# Introduction
-Marmot is an open-source data catalog designed for teams who want powerful data discovery without enterprise complexity. Built with a focus on simplicity and speed, Marmot helps you catalog assets across your entire data stack - from databases and APIs to message queues and data pipelines.
+Marmot is the open source **context layer** for your whole stack: a single catalog for every asset your systems and teams depend on, from services, APIs, queues, topics and brokers to databases, tables and pipelines. It exists to solve **context starvation**, the moment an engineer or an AI agent has to act without knowing what exists, who owns it, what it means, or what it connects to.
+
+Marmot is built so both **humans and agents** can ask that question and get a real answer. [Catalog your assets](Populating/index.md) once, enrich them with ownership and business context, and expose them through the UI, a [REST API](api-reference.md), and a built-in [MCP server](MCP/index.md) that lets AI agents read your catalog, then write back the [lineage](open-lineage.md) they generate.
@@ -20,32 +22,30 @@ import { CalloutCard, DocCard, DocCardGrid, FeatureCard, FeatureGrid } from '@si
icon="mdi:rocket-launch"
/>
-## Why Marmot?
+## Built for agents
-Unlike traditional catalogs that require extensive infrastructure and configuration, Marmot ships as a **single binary** with an intuitive UI, making it easy to deploy and start cataloging in minutes.
+AI agents are only as good as the context they can reach. Through a built-in MCP server and our SDKs, Marmot gives your agents a live, governed map of every asset in your stack: what exists, who owns it, what it means, and how it all connects.
-
-
-
-
+
-
-
+
+
+## Why Marmot?
+
+Most catalogs were built to help a data team document tables. Marmot is built to feed context to whoever needs it, human or agent, across every kind of asset: services, APIs, queues, topics, brokers, databases, tables and pipelines.
+
+That means agents are first class, not an afterthought. A native MCP server and our SDKs are part of the core, so your agents read the same governed context your team does. And Marmot stays light enough to actually adopt: a single binary backed only by PostgreSQL, with no platform team required.
## Architecture
@@ -55,62 +55,80 @@ Marmot is built entirely in Go with PostgreSQL being the only external dependenc
+ );
+ }
+
+ return (
+
+ {inner}
+
+ );
}
export function FeatureGrid({ children }: DocCardGridProps): JSX.Element {
diff --git a/web/docs/src/components/Hero.tsx b/web/docs/src/components/Hero.tsx
index 296953d8..d8b3bc0c 100644
--- a/web/docs/src/components/Hero.tsx
+++ b/web/docs/src/components/Hero.tsx
@@ -196,9 +196,9 @@ export default function Hero(): JSX.Element {
data-animate-delay="2"
className="text-4xl sm:text-5xl lg:text-6xl font-extrabold text-gray-900 dark:text-white mb-5 tracking-tight leading-[1.1]"
>
- Discover any data asset in seconds.
+ AI agents are only as good as
- Then let your AI do the same
+ the context they can reach.
- The open-source context layer for your AI. Catalog your tables,
- topics, queues and APIs then expose real metadata to your AI agents.
+ Marmot is the open source context layer for agents and
+ humans. Catalog every service, API, queue, topic, database and
+ pipeline then expose real, governed context to your AI agents and your
+ team.
+
+
+
+
+
+
+ Only metadata. Your data stays put.
+
+
+ A context layer needs to know about your assets, not to hold their
+ contents. Marmot is built so the data itself never leaves your
+ systems.
+