# 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:
dateWhen all files were last completely built. (All data is updated)pricesDateWhen card prices were updated on cards. (Prices data is updated)versionWhat version all files are on. (Updates withpricesDate)
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 is a 22-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 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 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 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.
Others Powered by MTGJSON
MTGJSON has allowed many different projects to serve data to their audiences and we're very proud of what our friends have accomplished. We'd like to highlight them here.
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.
