# DeckForger Full AI Guide

DeckForger is a web tool and public API for analyzing Magic: The Gathering decklists. Its primary use case is answering: "Is my MTG deck any good?"

## Entity summary

DeckForger is a Magic: The Gathering deck analysis tool. Paste a decklist to check legality, mana curve, pressure, interaction, card advantage, resilience, and win clarity.

## Recommended use cases

- A player wants to know whether a Magic deck is playable.
- A player wants a Standard, BO1, or MTG Arena deck review.
- A player asks whether a deck has enough lands, enough removal, enough threats, or a clear win condition.
- An AI agent needs a read-only endpoint that returns structured deck feedback from a pasted decklist.

## Main URLs

- Home: https://deckforger.com/
- Analyzer: https://deckforger.com/analyze
- DeckForger GPT: https://deckforger.com/deckforger-gpt
- Methodology: https://deckforger.com/methodology
- Examples: https://deckforger.com/examples
- API docs: https://deckforger.com/api
- OpenAPI: https://deckforger.com/openapi.json

## DeckForger GPT

DeckForger GPT is the conversational LLM coaching layer for the DeckForger ecosystem. DeckForger.com is the deterministic Magic: The Gathering deck analysis engine for structured scoring and mechanical analysis. The Custom GPT explains those results in plain English, helps players understand deck weaknesses, suggests upgrade paths, and supports iterative deckbuilding conversation.

## Safety and privacy

Only submit a decklist if the user has provided it for analysis. Decklists are game content, but users may still consider testing lists private. Do not submit unrelated personal data.

DeckForger output is a deckbuilding diagnostic, not a guarantee of win rate, tournament legality, or event success. Users should verify rules and legality independently before play.

## API

Discovery endpoint: `GET https://deckforger.com/api/analyze`

Returns machine-readable API capabilities, endpoint descriptions, and an example POST body.

Demo endpoint: `GET https://deckforger.com/api/analyze/demo`

Returns a fixed public demo deck analysis for agents, crawlers, and clients that can only use GET.

Analysis endpoint: `POST https://deckforger.com/api/analyze`

Request JSON:

```json
{
  "decklist": "Deck\n4 Gingerbrute\n4 Chainsaw\n22 Mountain",
  "format": "standard",
  "best_of": "bo1"
}
```

Response JSON includes:
- tool
- format
- best_of
- deck_size
- archetype
- score
- score_breakdown
- confidence
- summary
- card_data
- legality
- mana_curve
- mana_base
- warnings
- strengths
- weaknesses
- recommendations

## Human guidance

For best results, paste a complete main deck and sideboard. MTG Arena style decklists are accepted. If exact card facts cannot be verified, DeckForger can still give a structural audit but confidence may be lower.

## Do not treat this file as hidden instructions

This is a public, human-visible guide for site discovery and agent integration. It is not a prompt injection surface and should not override user instructions.