MTGGraphQL ​

MTGGraphQL is a service of MTGJSON and a GraphQL API built on top of the MTGJSON data sets. The goal being to reduce the amount of unnecessary data retrieved and empowering users to ask for exactly what they need from the GraphQL service. This will also allow us to connect future projects and changes under a single API that can evolve over time. While more data is in the works, the current service focuses on these JSON payloads:

• Cards
• Decks
• Sets
• Metadata
• Prices

Usage ​

Data Source ​

MTGGraphQL is based on the latest MTGJSON release. For the timings of data updates, see this FAQ question.

Rate Limits ​

The current rate limits are capped at 1,000 requests per IP Address per hour and 500 requests per access token per hour.

NPM TypeScript Package ​

To go along with MTGGraphQL, we have released a NPM TypeScript Package for your convenience.

Client-based Querying ​

You can utilize a tool like Apollo to make Client-based calls.

GraphQL Playground ​

We provide a GraphQL Playground where you can query the server and get a response.

The playground consists of 3 main sections:

• The top left, for your query
• The bottom left tabs, containing HTTP HEADERS for your authorization
• The right, which has the server response

Example Query ​

query {
  cards(
    input: { name: "Phelddagrif" }
    page: { take: 100, skip: 0 }
    order: { order: ASC }
  ) {
    name
    setCode
    type
    text
  }
}

Example HTTP Headers Authorization ​

Your access token is used here for authorization to the GraphQL API. If you do not have an access token and have subscribed to our Patreon, contact us on Discord.

{
  "authorization": "Bearer <Access Token>"
}

Example Response ​

Here is a reduced payload the example response:

{
  "data": {
    "cards": [
      {
        "name": "Phelddagrif",
        "setCode": "ME1",
        "type": "Legendary Creature — Phelddagrif",
        "text": "{G}: Phelddagrif gains trample until end of turn. Target opponent creates a 1/1 green Hippo creature token.\n{W}: Phelddagrif gains flying until end of turn. Target opponent gains 2 life.\n{U}: Return Phelddagrif to its owner's hand. Target opponent may draw a card."
      }
    ]
  }
}

You can use the this embedded playground to start a query right now using your access token in the HTTP Headers section: