# llms.txt

> llms.txt is an open-source MCP server for ai models and llm tooling. Generate an llms.txt from Markdown or a sitemap and check an existing file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://basitalisandhu.github.io/dev-mcp-servers/
- **Repository:** https://github.com/basitalisandhu/dev-mcp-servers/tree/HEAD/packages/llms-txt
- **MCP Registry name:** io.github.basitalisandhu/mcp-llms-txt
- **Categories:** AI models and LLM tooling, developer tools, marketing and SEO
- **Listing updated:** 2026-11-15

## About

Everything stays local: the server reads files you name and returns text, never writing a file and never fetching a URL. Two generators produce the output. One scans a directory for .md, .mdx and .markdown files, takes titles from frontmatter, the first H1 or the file name, groups pages by top-level folder and lists anything skipped. The other builds one link per entry in a local sitemap.xml, grouped by first path segment, with titles derived from URLs because pages are not fetched.

The checker validates an llms.txt against the convention and reports errors, warnings and info with line numbers: a single H1 first, a blockquote summary, H2 sections of link lines, no duplicates and a modest size. Sitemap-derived files have empty notes you fill in yourself.

It runs over stdio from a pinned Docker image with a read-only mount, and the package is not yet on npmjs.com. It is one of ten small servers in dev-mcp-servers, MIT licensed, with no telemetry.

## Features

- **Markdown directory scan:** Builds entries from up to 1000 Markdown files with titles and notes.
- **Sitemap conversion:** Turns a local sitemap.xml into grouped llms.txt links.
- **Convention checker:** Reports line-numbered errors and warnings on an existing file.
- **Local only:** No network access; reads only the named files.
- **Docker distribution:** Runs from a pinned image with a read-only mount.

## Good for

- Create a first llms.txt for a docs folder
- Convert a sitemap into llms.txt entries
- Lint an llms.txt before publishing
- Find which Markdown files were skipped

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-llms-txt -- docker run -i --rm ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-llms-txt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-llms-txt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-llms-txt": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-llms-txt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-llms-txt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0"
      ]
    }
  }
}
```

## Tools

- `generate_llms_txt`: Scan a Markdown directory and return llms.txt text with entries and skipped files.
- `generate_from_sitemap`: Build llms.txt links from a local sitemap.xml.
- `check_llms_txt`: Check an llms.txt against the convention with line-numbered findings.

## FAQ

### Does it fetch my pages?

No. It never fetches URLs; sitemap titles come from the URL paths.

### Does it write the file?

No. It returns text for you to review and save.

### Can I use npx?

Not yet; the README says the package is not on npmjs.com, so use the Docker image or GitHub Packages.

### What are the size limits?

Up to 1000 Markdown files of 1 MB each, or one sitemap up to 2 MB.

### Is llms.txt free?

Yes. llms.txt is open source, so you can use and self-host it for free.

### How do I add llms.txt to Claude Code?

Run this command in your terminal: claude mcp add mcp-llms-txt -- docker run -i --rm ghcr.io/basitalisandhu/mcp-llms-txt:0.3.0

### What are the best alternatives to llms.txt?

The closest alternatives to llms.txt are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/llms-txt-3
