feat(website): add the MCP landing page

.gitattributes

@@ -0,0 +1,7 @@
+# Regenerated by `pnpm --filter @rivet-gg/icons generate`, never hand-edited.
+# Collapsed in reviews and skipped by `git diff` so an icon repull does not
+# bury the change it came with.
+packages/icons/dist/** linguist-generated=true -diff
+packages/icons/src/index.gen.js linguist-generated=true -diff
+packages/icons/src/index.gen.ts linguist-generated=true -diff
+packages/icons/manifest.json linguist-generated=true -diff

.gitignore

@@ -30,5 +30,6 @@ src/content/docs/workflows
 /public/agentos/
 /public/cloud/
 /public/dynamic-apps/
+/public/docs/
 /public/workflows/
 /public/metadata/

Caddyfile

@@ -52,9 +52,44 @@
 
 	# www -> apex. Railway terminates TLS upstream, so always redirect to https.
 	# Only takes effect when www.rivet.dev is attached to the Railway service.
-	@www host www.rivet.dev
+	@www {
+		host www.rivet.dev
+		not path /mcp /mcp/
+	}
 	redir @www https://rivet.dev{uri} 301
 
+	# The former apex landing route now lives in the docs. Keep this redirect
+	# host-aware: an unconditional /mcp redirect would intercept the MCP service
+	# endpoint on mcp.rivet.dev before its reverse-proxy handler runs.
+	@mcpDocsPage {
+		not host mcp.rivet.dev
+		path /mcp /mcp/
+	}
+	redir @mcpDocsPage https://rivet.dev/docs/mcp/{http.request.uri.prefixed_query} 301
+
+	# mcp.rivet.dev redirects its root to the canonical docs page while the MCP
+	# server keeps every route it owns, which are proxied to MCP_UPSTREAM. A
+	# blanket host redirect is not possible: https://mcp.rivet.dev/mcp is the
+	# endpoint clients connect to. Only takes effect when mcp.rivet.dev is
+	# attached to the Railway service and MCP_UPSTREAM is set.
+	@mcpHost host mcp.rivet.dev
+	handle @mcpHost {
+		@mcpService path /mcp /mcp/* /.well-known/oauth-protected-resource /health /ready
+		handle @mcpService {
+			reverse_proxy {$MCP_UPSTREAM}
+		}
+
+		handle / {
+			redir https://rivet.dev/docs/mcp/{http.request.uri.prefixed_query} 301
+		}
+
+		# The service routes above are the only content this host serves; the rest
+		# of the site keeps one canonical home.
+		handle {
+			redir https://rivet.dev{uri} 301
+		}
+	}
+
 	# Real HTTP 301s for legacy/moved URLs. Generated from redirects.mjs by
 	# scripts/generate-caddy-redirects.mjs. The import path resolves relative to
 	# this Caddyfile, so it works both locally and in-container.
@@ -66,6 +101,9 @@
 	@needsSlash {
 		not path */
 		not path /health
+		# mcp.rivet.dev/mcp is an API endpoint, not a page: a trailing-slash
+		# redirect here would break every client the landing page configures.
+		not host mcp.rivet.dev
 		file {path}/index.html
 	}
 	redir @needsSlash {path}/{http.request.uri.prefixed_query} 301

examples/docs/mcp/call-actor-action.txt

@@ -0,0 +1 @@
+What has Acme been saying?

examples/docs/mcp/claude-code.sh

@@ -0,0 +1 @@
+claude mcp add --transport http rivet https://mcp.rivet.dev/mcp

examples/docs/mcp/codex.sh

@@ -0,0 +1 @@
+codex mcp add rivet --url https://mcp.rivet.dev/mcp

examples/docs/mcp/cursor.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "rivet": {
+      "url": "https://mcp.rivet.dev/mcp"
+    }
+  }
+}

examples/docs/mcp/find-running-actors.txt

@@ -0,0 +1 @@
+Which chat rooms are still awake?

examples/docs/mcp/gemini-cli.sh

@@ -0,0 +1 @@
+gemini mcp add --transport http rivet https://mcp.rivet.dev/mcp

examples/docs/mcp/inspect-actor-inline.txt

@@ -0,0 +1 @@
+Open the Actor Inspector for chat-room · acme.

examples/docs/mcp/local.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "rivet": {
+      "command": "npx",
+      "args": ["-y", "@rivet-dev/mcp", "--target", "local"]
+    }
+  }
+}

examples/docs/mcp/one-request.js

@@ -0,0 +1,10 @@
+// "Which chat rooms are still awake, and what has Acme been saying?"
+const { actors } = await rivet.actors.list({ name: "chat-room" });
+const awake = actors.filter((room) => room.status === "running");
+
+const history = await rivet.actor.action({
+  actor: { name: "chat-room", key: ["acme"] },
+  name: "getHistory",
+});
+
+return { awake: awake.length, history };

examples/docs/mcp/vs-code.sh

@@ -0,0 +1 @@
+code --add-mcp '{"name":"rivet","type":"http","url":"https://mcp.rivet.dev/mcp"}'