REST API

API Documentation

Programmatic access to every server JAR on mcjarfiles.com — Vanilla, Paper, Purpur, Leaf, Folia, modded loaders, Bedrock, and proxies.

4 endpoints 8+ server types No auth required AI-ready docs

Getting Started

Every endpoint is a plain HTTP GET request — no API key, token, or auth header required.

Base URL

All requests are made relative to this URL.

https://mcjarfiles.com/api

Try it now

https://mcjarfiles.com/api/get-latest-jar/servers/paper

Paste that URL into your browser — it redirects straight to the latest Paper server JAR.

Use with AI

Hand these docs to ChatGPT, Claude, Cursor, or your own agent so it can write download scripts, Dockerfiles, and server setups for you.

Give your AI the docs

One Markdown file with every endpoint, server type, response shape, and how to run each download.

Open in Claude Open in ChatGPT View .md

Agent Skill

A SKILL.md that teaches Claude Code and other skill-aware agents when and how to use the API.

curl -fsSL --create-dirs -o ~/.claude/skills/mcjarfiles/SKILL.md https://mcjarfiles.com/skills/mcjarfiles/SKILL.md

Download SKILL.md

OpenAPI spec

Import into Custom GPT Actions, tool-calling frameworks, Postman, or a client generator.

https://mcjarfiles.com/openapi.json

llms.txt

The standard index AI crawlers and coding agents look for. The full text is at /llms-full.txt.

https://mcjarfiles.com/llms.txt

Endpoints

Four GET endpoints cover every server type on the site. Jump to the full reference below for parameters and examples.

GET

/api/get-jar/{type}/{variant}/{version}

Redirects to the server file for a specific type, variant, and version.

GET

/api/get-latest-jar/{type}/{variant}

Redirects to the newest available server file for the specified type and variant.

GET

/api/get-version-info/{type}/{variant}/{version}

Retrieves build, channel, timestamp, and icon metadata for one specific version.

GET

/api/get-versions/{type}/{variant}

Lists every available version identifier for a type and variant, newest first.

Server Types & Variants

Pass type and variant as path segments — for example /servers/paper or /modded/fabric.

Vanilla

Official Minecraft server versions from Mojang

releasesnapshot

Servers

Performance-optimized server software

paperpurpurleafmcfolia

Modded

Frameworks for modded Minecraft servers

fabricforgeneoforge

Bedrock

Bedrock edition — requires an extra /windows or /linux path segment

latestpreview

Proxies

Proxy server software for network management

velocity

API Reference

Full path parameters, response codes, and examples for each endpoint.

GET/api/get-jar/{type}/{variant}/{version}

Redirects to the server file for a specific type, variant, and version.

Path Parameters

typerequiredOne of vanilla, servers, modded, bedrock, proxies

variantrequiredA valid variant for the selected type, e.g. paper or forge

versionrequiredA specific version, e.g. 1.21.8

When type is bedrock, an extra path segment — /windows or /linux — is required between variant and version.

Responses

302Redirect to the file on the official download host

400Invalid parameters

404Resource not found

500Server issue

Example Requests

GET https://mcjarfiles.com/api/get-jar/vanilla/release/1.21.1

GET https://mcjarfiles.com/api/get-jar/servers/leafmc/26.2

GET https://mcjarfiles.com/api/get-jar/bedrock/latest/windows/1.21.100.7

Response Codes

Every endpoint uses these HTTP status codes consistently.

200Success — JSON response

302Redirect — download endpoints send you to the official upstream file; follow redirects

400Bad Request — missing or invalid parameters

404Not Found — check type, variant, or version

500Internal Server Error — try again shortly

Need help or found a bug?

Join the Discord for support, or head back and grab a JAR the easy way.

Join Discord ← Back to Downloads