Agent traffic 64.3467%

The knowledge infrastructure agents build on

Self-updating documentation for startups, enterprises, and agents.

MCP & llms.txt auto-generated Free for open source
Getting Started

Quickstart Guide

Start building intelligent, agent-ready documentation in under five minutes.

Quickstart

Deploy your first docs site in minutes with our step-by-step guide.

Installation

Install the CLI to preview and validate docs & MCP schemas locally.

Web Editor

Make quick updates in the browser with automatic Git pull requests.

Components

Build rich, interactive documentation with typed MDX primitives.

npx @folio/cli init docs && npx @folio/cli dev --mcp
AI Assistant

Ask Folio Assistant

Grounded answers for engineers and coding agents, cited straight from your Git repo.

Folio Agent · Cited from /mcp/setup.mdx 42ms
Add your hosted Folio endpoint https://docs.yourapp.com/mcp to Cursor or Claude Desktop. Every MDX page and OpenAPI operation is exposed as a typed tool automatically.
Configuration

Global Settings

Toggle capabilities in folio.json — zero build plugins required.

Auto-generate llms.txt Publish concise and full agent indexes on every push
Hosted MCP Server Expose semantic search & API schemas via Model Context Protocol
PR Drift Detection Suggest doc diffs automatically when API routes change
folio.json
{
  "name": "Acme Cloud",
  "llmsTxt": true,
  "mcpServer": true,
  "prDrift": false
}
Agent Readiness

AI Optimization

Structured markdown, semantic chunking, and token budgets tuned for autonomous agents.

Agent Resolution 98.4%
Avg Context 1,420 tok
MCP Latency 38 ms
GET /llms.txt · 200 OK
# Folio Knowledge Index
> Self-updating docs for humans and agents

## Core Guides
- [Quickstart](/quickstart.md): Deploy in 5 minutes
- [MCP Server](/mcp.md): Connect Cursor & Claude
- [OpenAPI Spec](/openapi.json): 42 typed endpoints
MDX Primitives

Interactive Components

Drop-in callouts, API endpoint headers, and typed parameter tables.

Agent Tip: Every Folio page automatically renders a clean .md twin when requested with Accept: text/markdown.
POST /v1/knowledge/sync
sync.mdx
<ParamField body="branch" type="string" required>
  Git branch to index into your MCP knowledge graph.
</ParamField>
Appearance

Custom Themes

Match your brand tokens out of the box with accessible contrast presets.

LIVE THEME PREVIEW
Authentication & API Keys
Scoped bearer tokens with automatic rotation and audit trails across workspaces.

Trusted by engineering teams shipping to humans and autonomous agents

Built for velocity

Documentation that stays in lockstep with your codebase

Write in MDX, review in Git, and publish simultaneously to a fast web portal, an MCP server, and clean llms.txt manifests.

Git-Synced Docs

Every pull request spins up an isolated preview URL and flags stale API parameters before you merge to main.

- timeout: 3000 // deprecated
+ timeoutMs: 3000 // synced PR #418
+ retryPolicy: "exponential"

MCP & llms.txt Native

Serve structured context directly to Claude, Cursor, Windsurf, and custom agents with zero scraping or fragile embeddings.

/llms.txt 4.2 KB
/llms-full.txt Indexed
/mcp SSE Live

Interactive API Playground

Import OpenAPI 3.1 or AsyncAPI specs to generate runnable request consoles and idiomatic SDK snippets automatically.

POST /v1/agents/run 200 OK
{ "status": "indexed", "chunks": 184 }
One source, every consumer

Author once in MDX. Compile for humans and agents.

Switch between the source file, the compiled llms.txt output, and the live MCP tool definition generated automatically on push.

---
title: Create Knowledge Index
api: POST /v1/indexes
agentPriority: high
---

Create a real-time vector and lexical index backed by your Git repository.

<ParamField body="repo" type="string" required>
  GitHub repository slug (e.g. `acme/api-docs`).
</ParamField>

<ParamField body="mcp" type="boolean" default="true">
  Expose this index on your hosted `/mcp` endpoint.
</ParamField>
Rendered Docs Page

Create Knowledge Index

Create a real-time vector and lexical index backed by your Git repository.

POST https://api.folio.pombot.dev/v1/indexes
repo · string required
mcp · boolean default: true
Simple pricing

Scale from first commit to enterprise traffic

Every plan includes Git sync, custom domains, and native llms.txt generation.

Hobby

$0 / month

For indie developers, open-source SDKs, and side projects.

  • Unlimited public MDX pages
  • Auto-generated llms.txt & sitemap
  • GitHub branch preview deployments
  • Custom domain with automatic TLS

Enterprise

Custom

For global organizations with strict governance and private docs.

  • SAML SSO, SCIM & role-based access
  • Private MCP endpoints & VPC peering
  • Multi-repo docs & automated PR drift
  • 99.99% SLA & dedicated solutions engineer

Make your documentation the fastest path to production

Connect your GitHub repository and ship an agent-ready docs portal in under five minutes.