Menu

server.json Validator. Check it before you publish.

Paste your MCP Registry server.json and check it against the official 2025-12-11 schema and the registry's own publishing rules, without leaving your browser.

Validate your server.json

Your file stays in this page. Nothing is uploaded.

Checked against the official server.json schema 2025-12-11 and the registry’s official registry requirements, as of 28 October 2026. Your file stays in this page.

Schema: server.schema.json 2025-12-11. Publishing rules: the registry's documentation. Both checked 28 October 2026.

How to use it

How to use the server.json Validator

Paste the whole file, or load the valid or broken example to see how it works, then select Validate. Errors block publishing; warnings are accepted but worth fixing.

Each message names the field, such as packages[0].version, and what is wrong. Below the results is the list of checks the registry runs only when you publish, such as proving you own the namespace.

Limits

What it can't tell you

It can't run the checks that need the internet or your accounts: namespace ownership, whether your npm or PyPI package exists and names the server, OCI image labels, or whether a version was already published. The registry runs those when you publish.

The registry and its schema still change. We implemented schema 2025-12-11, the current version on 28 October 2026. Files on older schema versions get a warning, as the registry gives.

FAQ

Common questions

What is server.json?
The metadata file that describes an MCP server for the official MCP Registry: its name, description, version and how to install or reach it, through packages, remotes or both.
Which fields are required in server.json?
The schema requires name, description and version, and the registry also rejects a file without $schema. Each package needs registryType, identifier and transport; each remote needs type and url.
Why is my description rejected?
The 2025-12-11 schema limits description to 100 characters. Put the longer explanation in your README or on your website.
Can I use a version range like ^1.0.0?
No. The registry needs one specific version and rejects latest and ranges such as ^1.2.3, ~1.2.3, >=1.0.0 or 1.x.

Project Managers who will work with you on your project!

Wondering what this costs? Every service has published pricing, and you don't need a discovery call to see it.

View pricing

Building an MCP server?

We build MCP servers and integrations with Claude Code, tested against the current specification and reviewed by an engineer before anything ships.

See MCP Development →

Get a FREE Website Audit

Enter your website and get a 20–30 page SEO, GEO, AEO & CRO audit within 24 hours. Completely free.

Don't have a site yet? Get in touch →

Ready to speak with a marketing expert?
Give us a call! (916) 866-7893

Websites Launched
1407
Websites Launched
Marketing Experts
29
Marketing Experts
Hours of Dedicated Work
204533
Hours of Dedicated Work
Irina S.Benjamin G.Jeanette M.David G.