Skip to content

Open-source status page, incident response and uptime monitoring

chore: improve ai web endpoints (#2158)

Maximilian Kaske8153c53c6ce0
diff --git a/apps/web/next.config.ts b/apps/web/next.config.ts
index 9fc54162b..cf27cb8d8 100644
--- a/apps/web/next.config.ts
+++ b/apps/web/next.config.ts
@@ -32,9 +32,11 @@ const securityHeaders = [
const homepageLinkHeader = [
'</.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json"',
'</.well-known/agent-skills/index.json>; rel="agent-skills"; type="application/json"',
+ '</.well-known/mcp.json>; rel="mcp-server"; type="application/json"',
'<https://docs.openstatus.dev>; rel="service-doc"; type="text/html"',
'<https://api.openstatus.dev/openapi>; rel="service-desc"; type="application/json"',
'<https://www.openstatus.dev/llms.txt>; rel="describedby"; type="text/plain"',
+ '<https://www.openstatus.dev/llms-full.txt>; rel="alternate"; type="text/plain"; title="llms-full"',
'<https://www.openstatus.dev/terms>; rel="terms-of-service"',
'<https://www.openstatus.dev/privacy>; rel="privacy-policy"',
].join(", ");
@@ -277,6 +279,11 @@ const nextConfig: NextConfig = {
],
destination: "https://www.stpg.dev/_next/:path*",
},
+ // Markdown via .md URL suffix (e.g. /blog/foo.md → /api/markdown/blog/foo)
+ {
+ source: "/:path*\\.md",
+ destination: "/api/markdown/:path*",
+ },
// Markdown content negotiation for AI tools
{
source: "/:path*",
diff --git a/apps/web/public/llms.txt b/apps/web/public/llms.txt
deleted file mode 100644
index 745aee784..000000000
--- a/apps/web/public/llms.txt
+++ /dev/null
@@ -1,63 +0,0 @@
-# openstatus
-
-Openstatus is an open-source uptime monitoring and status page platform founded in 2023 by Thibault Le Ouay Ducasse and Maximilian Kaske. It monitors websites, APIs, and services from 28 regions globally across multiple cloud providers (Fly.io, Koyeb, Railway). Openstatus is bootstrapped, not VC-funded, and available both as a managed SaaS and for self-hosting.
-
-## Who it's for
-
-- Development teams that want transparent incident communication
-- Companies that need multi-region uptime monitoring
-- Teams that prefer infrastructure-as-code workflows (monitoring as code via YAML)
-- Organizations that require self-hosted monitoring behind a firewall (private locations)
-- Open-source projects and startups looking for a free or affordable monitoring solution
-
-## Pricing
-
-- **Hobby** — $0/month: 1 monitor, 6 regions, 10m check interval, 1 status page, 3 page components, 14-day data retention
-- **Starter** — $30/month: 20 monitors, 28 regions, 1m check interval, 1 status page, 20 components, 3-month retention, subscribers, custom domain, WhatsApp/SMS/PagerDuty alerts
-- **Pro** — $100/month: 50 monitors, 28 regions, 30s check interval, 5 status pages, 50 components, 12-month retention, private locations, OTel exporter, 20 notification channels
-
-Pricing is available in USD, EUR, and INR.
-
-## Key Features
-
-- **28-region monitoring**: Parallel checks across Europe, North America, South America, Asia, Africa, and Oceania — no round-robin, all regions fire simultaneously
-- **Multi-cloud**: Monitors run on Fly.io, Koyeb, and Railway for true cloud diversity
-- **Status Pages**: Branded public or password-protected pages with custom domains, themes, maintenance windows, and subscriber notifications (email, RSS, SSH)
-- **API Monitoring**: Assertions, thresholds, status code checks, header and body validation
-- **Monitoring as Code**: Define monitors in YAML, manage via CLI or GitHub Actions
-- **Private Locations**: 8.5MB Docker image for monitoring internal services behind firewalls
-- **Alerting**: Email, Slack, Discord, webhook, WhatsApp, SMS, PagerDuty, OpsGenie, Grafana OnCall
-- **OpenTelemetry**: Export synthetic check metrics to any OTLP endpoint
-- **SDK**: Node.js SDK available on JSR (@openstatus/sdk-node)
-- **Open-source**: AGPL-3.0-licensed, self-hostable, 8k+ GitHub stars
-
-## Key Differentiators
-
-- Open-source and bootstrapped (no VC funding)
-- Parallel scheduling strategy — all selected regions check simultaneously (vs. round-robin competitors)
-- Unlimited team members on paid plans
-- Status page subscribers included (not a paid add-on)
-- Private status pages included in team plan (not an additional charge)
-- Self-hosting option with full feature parity
-
-## Comparisons
-
-- [openstatus vs BetterStack](https://www.openstatus.dev/compare/betterstack)
-- [openstatus vs Checkly](https://www.openstatus.dev/compare/checkly)
-- [openstatus vs UptimeRobot](https://www.openstatus.dev/compare/uptime-robot)
-- [openstatus vs Uptime Kuma](https://www.openstatus.dev/compare/uptime-kuma)
-
-## Links
-
-- [About](https://www.openstatus.dev/about)
-- [Pricing](https://www.openstatus.dev/pricing)
-- [Changelog](https://www.openstatus.dev/changelog)
-- [Global Speed Checker](https://www.openstatus.dev/play/checker)
-- [Theme Store](https://themes.openstatus.dev)
-- [Dashboard](https://app.openstatus.dev)
-- [Documentation](https://docs.openstatus.dev/)
-- [Documentation llms docs](https://docs.openstatus.dev/llms.txt)
-- [Documentation llms docs full](https://docs.openstatus.dev/llms-full.txt)
-- [GitHub](https://github.com/openstatushq/openstatus)
-- [SDK](https://jsr.io/@openstatus/sdk-node)
-- [API](https://api.openstatus.dev/openapi)
diff --git a/apps/web/src/app/(ai)/llms-full.txt/route.ts b/apps/web/src/app/(ai)/llms-full.txt/route.ts
new file mode 100644
index 000000000..75e067085
--- /dev/null
+++ b/apps/web/src/app/(ai)/llms-full.txt/route.ts
@@ -0,0 +1,54 @@
+import { convertMdxToMarkdown } from "@/content/convert";
+import {
+ PRODUCT_CONTEXT_MARKDOWN,
+ PRODUCT_SUMMARY,
+} from "@/content/llms-context";
+import {
+ type MDXData,
+ getHomePage,
+ getProductPages,
+ getToolingPages,
+ getUnrelatedPages,
+} from "@/content/utils";
+
+export const runtime = "nodejs";
+export const revalidate = 3600;
+
+const BASE = "https://www.openstatus.dev";
+
+function renderPage(page: MDXData): string {
+ const md = convertMdxToMarkdown(page);
+ return `<!-- ${BASE}${page.href} -->\n\n${md}`;
+}
+
+export function GET() {
+ const pages: MDXData[] = [
+ getHomePage(),
+ ...getProductPages(),
+ ...getToolingPages(),
+ ...getUnrelatedPages().filter((p) => p.slug !== "not-found"),
+ ];
+
+ const chunks = pages.map(renderPage);
+
+ const intro = [
+ "# openstatus — full content",
+ "",
+ `> ${PRODUCT_SUMMARY} Blog posts, changelog entries, guides, use cases, and comparisons live in [llms.txt](https://www.openstatus.dev/llms.txt) as links — not inlined here.`,
+ "",
+ PRODUCT_CONTEXT_MARKDOWN,
+ "",
+ "---",
+ "",
+ ].join("\n");
+
+ const body = `${intro}${chunks.join("\n\n---\n\n")}\n`;
+
+ return new Response(body, {
+ headers: {
+ "Content-Type": "text/plain; charset=utf-8",
+ "Cache-Control":
+ "public, max-age=3600, s-maxage=3600, stale-while-revalidate=3600",
+ },
+ });
+}
diff --git a/apps/web/src/app/(ai)/llms.txt/route.ts b/apps/web/src/app/(ai)/llms.txt/route.ts
new file mode 100644
index 000000000..8cd47ac0f
--- /dev/null
+++ b/apps/web/src/app/(ai)/llms.txt/route.ts
@@ -0,0 +1,113 @@
+import {
+ PRODUCT_CONTEXT_MARKDOWN,
+ PRODUCT_SUMMARY,
+} from "@/content/llms-context";
+import {
+ type MDXData,
+ getBlogPosts,
+ getChangelogPosts,
+ getComparePages,
+ getGuides,
+ getProductPages,
+ getToolingPages,
+ getToolsPages,
+ getUnrelatedPages,
+ getUseCasePages,
+} from "@/content/utils";
+
+export const runtime = "nodejs";
+export const revalidate = 3600;
+
+const BASE = "https://www.openstatus.dev";
+
+type Item = { title: string; href: string; description?: string };
+
+function toItem(page: MDXData, withDescription = false): Item {
+ return {
+ title: page.metadata.title,
+ href: page.href,
+ description: withDescription ? page.metadata.description : undefined,
+ };
+}
+
+function renderSection(title: string, items: Item[]): string {
+ if (!items.length) return "";
+ const lines = items
+ .map((it) =>
+ it.description
+ ? `- [${it.title}](${BASE}${it.href}): ${it.description}`
+ : `- [${it.title}](${BASE}${it.href})`,
+ )
+ .join("\n");
+ return `## ${title}\n\n${lines}\n`;
+}
+
+export function GET() {
+ const body = [
+ "# openstatus",
+ "",
+ `> ${PRODUCT_SUMMARY}`,
+ "",
+ PRODUCT_CONTEXT_MARKDOWN,
+ "",
+ renderSection(
+ "Product",
+ getProductPages().map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Tooling",
+ getToolingPages().map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Guides",
+ getGuides().map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Use Cases",
+ getUseCasePages().map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Comparisons",
+ getComparePages().map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Playground",
+ getToolsPages()
+ .filter((t) => t.slug !== "checker-slug")
+ .map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Pages",
+ getUnrelatedPages()
+ .filter((p) => p.slug !== "not-found")
+ .map((p) => toItem(p, true)),
+ ),
+ renderSection(
+ "Blog",
+ getBlogPosts().map((p) => toItem(p)),
+ ),
+ renderSection(
+ "Changelog",
+ getChangelogPosts().map((p) => toItem(p)),
+ ),
+ "## Optional",
+ "",
+ "- [API OpenAPI](https://api.openstatus.dev/openapi)",
+ "- [Documentation](https://docs.openstatus.dev/)",
+ "- [Documentation llms.txt](https://docs.openstatus.dev/llms.txt)",
+ "- [Documentation llms-full.txt](https://docs.openstatus.dev/llms-full.txt)",
+ "- [GitHub](https://github.com/openstatushq/openstatus)",
+ "- [SDK (JSR)](https://jsr.io/@openstatus/sdk-node)",
+ "- [Theme Store](https://themes.openstatus.dev)",
+ "- [Dashboard](https://app.openstatus.dev)",
+ "",
+ ].join("\n");
+
+ return new Response(body, {
+ headers: {
+ "Content-Type": "text/plain; charset=utf-8",
+ "Cache-Control":
+ "public, max-age=3600, s-maxage=3600, stale-while-revalidate=3600",
+ },
+ });
+}
diff --git a/apps/web/src/app/(ai)/mcp/route.ts b/apps/web/src/app/(ai)/mcp/route.ts
new file mode 100644
index 000000000..dc30e23c9
--- /dev/null
+++ b/apps/web/src/app/(ai)/mcp/route.ts
@@ -0,0 +1,11 @@
+// Discovery endpoint for /mcp. JSON clients receive the server card inline
+// (no domain coupling); browsers get redirected to the human-readable page.
+import { GET as serverCardGET } from "@/app/.well-known/mcp/server-card.json/route";
+
+export function GET(request: Request) {
+ const accept = request.headers.get("accept") ?? "";
+ if (accept.includes("application/json")) {
+ return serverCardGET();
+ }
+ return Response.redirect(new URL("/tooling/mcp-server", request.url), 302);
+}
diff --git a/apps/web/src/app/.well-known/mcp.json/route.ts b/apps/web/src/app/.well-known/mcp.json/route.ts
new file mode 100644
index 000000000..4fd6a40fa
--- /dev/null
+++ b/apps/web/src/app/.well-known/mcp.json/route.ts
@@ -0,0 +1,3 @@
+// Alias of /.well-known/mcp/server-card.json for crawlers that probe the
+// shorter, conventional path. Both must stay in lockstep — re-export only.
+export { GET } from "../mcp/server-card.json/route";
diff --git a/apps/web/src/content/llms-context.ts b/apps/web/src/content/llms-context.ts
new file mode 100644
index 000000000..42248d273
--- /dev/null
+++ b/apps/web/src/content/llms-context.ts
@@ -0,0 +1,45 @@
+// Product context surfaced in /llms.txt and /llms-full.txt so agents have
+// pricing, audience, and differentiators without crawling individual pages.
+// Keep numbers in sync with src/content/pages/unrelated/pricing.mdx.
+
+export const PRODUCT_SUMMARY =
+ "Openstatus is an open-source uptime monitoring and status page platform. It runs synthetic checks in parallel from 28 regions across Fly.io, Koyeb, and Railway, surfaces incidents on branded status pages, and exposes a REST API plus MCP server for programmatic control. Available as managed SaaS or self-hosted (AGPL-3.0). Bootstrapped, founded in 2023.";
+
+export const PRODUCT_CONTEXT_MARKDOWN = `## Who it's for
+
+- Development teams that want transparent incident communication
+- Companies that need multi-region uptime monitoring
+- Teams that prefer infrastructure-as-code workflows (monitoring as code via YAML)
+- Organizations that require self-hosted monitoring behind a firewall (private locations)
+- Open-source projects and startups looking for a free or affordable monitoring solution
+
+## Pricing
+
+- **Hobby** — $0/month: 1 monitor, 6 regions, 10m check interval, 1 status page, 3 page components, 14-day data retention
+- **Starter** — $30/month: 20 monitors, 28 regions, 1m check interval, 1 status page, 20 components, 3-month retention, subscribers, custom domain, WhatsApp/SMS/PagerDuty alerts
+- **Pro** — $100/month: 50 monitors, 28 regions, 30s check interval, 5 status pages, 50 components, 12-month retention, private locations, OTel exporter, 20 notification channels
+
+Annual billing gives 2 months free (Starter $300/yr, Pro $1,000/yr). Pricing is available in USD, EUR, and INR.
+
+## Key Features
+
+- **28-region monitoring** — Parallel checks across Europe, North America, South America, Asia, Africa, and Oceania; no round-robin, all selected regions fire simultaneously
+- **Multi-cloud** — Monitors run on Fly.io, Koyeb, and Railway for true cloud diversity
+- **Status Pages** — Branded public or password-protected pages with custom domains, themes, maintenance windows, and subscriber notifications (email, RSS, Slack)
+- **API Monitoring** — Assertions, thresholds, status code checks, header and body validation
+- **Monitoring as Code** — Define monitors in YAML, manage via CLI or GitHub Actions
+- **Private Locations** — 8.5MB Docker image for monitoring internal services behind firewalls
+- **Alerting** — Email, Slack, Discord, webhook, WhatsApp, SMS, PagerDuty, OpsGenie, Grafana OnCall
+- **OpenTelemetry** — Export synthetic check metrics to any OTLP endpoint
+- **SDK** — Node.js SDK on JSR (@openstatus/sdk-node)
+- **MCP server** — Streamable-HTTP MCP at https://api.openstatus.dev/mcp for status reports, maintenance windows, and monitor reads
+- **Open-source** — AGPL-3.0-licensed, self-hostable, 8k+ GitHub stars
+
+## Key Differentiators
+
+- Open-source and bootstrapped (no VC funding)
+- Parallel scheduling — all selected regions check simultaneously (vs. round-robin competitors)
+- Unlimited team members on paid plans
+- Status page subscribers included (not a paid add-on)
+- Private status pages included in the team plan (not an additional charge)
+- Self-hosting option with full feature parity`;