# What Is MTGJSON?

# How It Works

MTGJSON is an open-source project that catalogs all Magic: The Gathering cards in a portable format. A dedicated group of fans maintains and supplies data for a variety of projects and sites in the community. Using an aggregation process we fetch data between multiple resources and approved partners, and combine all this data in to various JSON files that you can learn about and download from this website.

The version file, which describes the metadata of all available files contains 3 principle properties:

  • date When all files were last completely built. (All data is updated)
  • pricesDate When card prices were updated on cards. (Prices data is updated)
  • version What version all files are on. (Updates with pricesDate)

Builds for JSON files run weekly at 4PM EST (typically on Sundays) while rebuilds for new prices are run daily around the same time.

In the version file and meta in associated files, when the files are rebuilt to update card prices, the pricesDate value will update and that date will be appended to the current version, for example, v4.6.0+20191129. Rebuilds that update card prices are fully backwards compatible with its primary release.

# The Team

Zach - Lead Developer & Maintainer

Zach Zach is a 23-year old hippo fanatic who loves playing with big data and giving back to the community in unique ways. He has worked on MTGJSON since 2016, and has led the design and development of version 4. His work can also be seen heavily in the open-source Cockatrice game client.

All inquires about MTGJSON can be sent to [email protected]

Eric - Documentation Developer

Eric Eric is a conceptualizer that loves cervidae, nature, cheesy sci-fi movies and delving in to any code he can find. He has worked on the MTGJSON documentation since 2018 and is an avid supporter of open-source software and the MTG community.

Mark - Cloud Developer

Mark Mark is an old man obsessed with learning anything he can, a self-proclaimed Jack of All Trades, yet Master of None. He spends his time gaming, writing, farming, cuddling with his dogs, and providing comedic relief.

Martin - Web Developer

Martin Martin is an avid strategy gamer and Magic player since late 1994. When he’s not looking at Javascript or playing commander, he’s likely spending time on a host of smaller projects, including the custom card creator MTG.Design.

# Contributing

Many others have devoted their time and effort in to this project. If you have suggestions for improvements, bug reports, or would just like to help address existing issues, we are always looking for help. You can contribute to the project through the main MTGJSON repo or the MTGJSON website repo. If you would like to help in other ways please consider donating to the project via Paypal (one-time donation) or via Patreon (reoccurring donations).

# Supporters

Our Patreon Supporters

Without our Patreon supporters we would not be able to keep this site running. They keep the lights on here and we would like to highlight their efforts in supporting this project.

Don't see your project? Join the Discord and let us know or open an issue on GitHub. We'll be happy to add your work to our list.
Last Updated: 2020-02-02