---
title: Introduction
description: arXivv is the missing data layer for arXiv, built for AI and LLMs. Swap the host, or add an extension to a paper ID.
sidebar:
  order: 1
---

arXivv serves every arXiv paper as clean Markdown, JSON and plain text, built from one canonical document tree. It is open: no sign-up, no API keys.

## Two rules

| Rule                                           | Example                             | Result                |
| ---------------------------------------------- | ----------------------------------- | --------------------- |
| **Drop-in:** swap `arxiv.org` for `arxivv.org` | `https://arxivv.org/abs/1706.03762` | arXiv's own response  |
| **Our formats:** `/<paper>.<format>`           | `https://arxivv.org/1706.03762.md`  | The paper as Markdown |

Formats are `md`, `json` and `txt`. Parts of a paper live under `/<paper>/`.

```bash
curl https://arxivv.org/1706.03762.md
curl https://arxivv.org/1706.03762/outline.json
curl https://arxivv.org/1706.03762/sections/S3.2.md
```

## Endpoints

| Resource                 | URL                                                      |
| ------------------------ | -------------------------------------------------------- |
| Markdown                 | `arxivv.org/1706.03762.md`                               |
| JSON                     | `arxivv.org/1706.03762.json`                             |
| Plain text               | `arxivv.org/1706.03762.txt`                              |
| Metadata (never builds)  | `arxivv.org/1706.03762/metadata.json`                    |
| A specific version       | `arxivv.org/1706.03762v7.md`                             |
| Outline                  | `arxivv.org/1706.03762/outline.json`                     |
| Section (anchor or slug) | `arxivv.org/1706.03762/sections/S3.2.md`                 |
| References               | `arxivv.org/1706.03762/references.json`                  |
| Figures and tables       | `arxivv.org/1706.03762/figures.json`                     |
| One figure               | `arxivv.org/1706.03762/figures/F1.json`                  |
| Figure image             | `arxivv.org/1706.03762v7/assets/Figures/ModalNet-21.png` |
| OpenAPI document         | `arxivv.org/openapi.json`                                |
| MCP server               | `mcp.arxivv.org/mcp` (also `arxivv.org/mcp`)             |

## Next

- [Drop-in compatibility](/drop-in): which hosts are proxied, and how.
- [Formats and versions](/formats): what each format contains and how caching works.
- [Document model](/document-model): the tree, anchors and aliases.
- [First request](/first-request): `Prefer: wait` and async builds.
- [MCP server](/mcp): tools for agents.
- [API reference](/api): every endpoint, header and error.

## Self-hosting and source

The source is on GitHub at [jamiedavenport/arxivv.org](https://github.com/jamiedavenport/arxivv.org).