Quickstart - Context7 MCP

1. Add your docs

In a new folder, create a docs.json file:

You can skip this step if your project already has a docs.json or mint.json file.

docs.json

{
  "$schema": "https://context7.com/schema/docs7.json",
  "name": "My docs",
  "colors": {
    "primary": "#16A34A"
  },
  "navigation": {
    "groups": [
      {
        "group": "Guide",
        "pages": ["index"]
      }
    ]
  }
}

name, colors.primary, and navigation are required. theme is optional: Docs7 renders every site with the mint theme. The dev server reports a missing field as docs.json is invalid. Then add the first page:

index.mdx

---
title: Introduction
description: Welcome to my docs
---

Hello, world.

2. Install the CLI

Use Node.js 20.19 or newer. Install the package globally:

npm install -g @upstash/docs7

This adds the docs7 command to your terminal.

3. Start the dev server

Run this from the folder that contains docs.json:

docs7 dev

Open http://localhost:3000, or the address that the command prints. The page reloads when you edit a file. The first run downloads the renderer and caches it for later. You can also pass a project folder or use another port:

docs7 dev ./docs --port 4000

You can also run the CLI without installing it: npx @upstash/docs7 dev.

4. Publish

With the CLI

Run these commands from your documentation folder:

docs7 login
docs7 deploy

The login command shows a one-time code and an approval link. Press Enter to open the browser, then approve access with your Context7 account. docs7 deploy publishes to production without a GitHub repository. It shows the site overview link and prints the public URL when the build is ready. Run docs7 deploy again after you edit your docs to update the same site. Keep .docs7/project.json, which stores the site link. See the CLI reference for login options, previews, and upload exclusions.

With GitHub

Push the project to GitHub.
Open the Docs7 tab in your Context7 teamspace.
Click Add New Site and choose the repository.
Set the production branch and the folder that contains docs.json.
Click Publish Site.

Every push to the production branch creates a new deployment. Pull requests get a preview site. Next, learn how production and preview builds work or browse the MDX components.

​1. Add your docs

​2. Install the CLI

​3. Start the dev server

​4. Publish

​With the CLI

​With GitHub

1. Add your docs

2. Install the CLI

3. Start the dev server

4. Publish

With the CLI

With GitHub