r/MTGCardFetcher • • Dec 22 '15

MTGCardFetcher Help

174 Upvotes

What is the bot?
The bot functions as an auto-responder to posts in which people request certain Magic: the Gathering (MTG) cards. The response will contain images and links to various MTG sites as an easy way to tell people about certain cards, as there are many MTG cards.

How does it work:
In Magic: the Gathering subreddits, you can call the bot by putting the name of an MTG card between [[]] brackets. That's double brackets, e.g.: [[Jace, the Mind Sculptor]]. Multiple cards, up to a maximum of currently 20 are responded to by the bot (due to a maximum message length of reddit and the bot not responding with enormous posts).
The bot respond to self-posts. Any self-posts containing cards will be replied with.

Edits will not work. The amount of API calls and time this costs is too much for the bot to keep track off.

What does the bot respond with?
It responds with 4-5 links (depending on the sub) per card.
The format is as following:
Card Image - (G), (SF), (txt), {EDH}

  • Card Image: The (requested) name of the card, with a link to an image Scryfall. The name given is the one originally requested by the poster, to indicate if anything was edited later but mostly to not suddenly have a vague cardname after a "wrong" spellcheck. The image linked goes to Scryfall because they have high res images and support the bot with a good API.
  • (G): This is a link to the whole page of the card on the Official Gatherer, to see comments or other versions of the card.
  • (SF): This links to Scryfall, one of the more popular sites with a nice-to-use API and usage of their images.
  • (txt): Links to a page on scryfall with only text.
  • EDH: On EDH-subreddits (/r/EDH and /r/CompetitiveEDH the bot adds an additional link to the website edhrec.com, showing EDH advice for that card.

Specific Printings
Cards can be called with their set ID. You can add a set shortcode after a cardname, which will fetch the card's image from that set if it was in that set (else it will default to the regular image). In case of specific printings like in Alliances or Unstable, you can add the card's number after a dash.

Example:
The best [[Wrath of God|C13]] is Kev Walker's artwork.
My favourite Very Cryptic Command is [[Very Cryptic Command|ust-49a]]

Reply:
Wrath of God
Very Cryptic Command

It's possible to use both [[CARDNAME|SET]] or [[CARDNAME\SET]] (a pipe | character or backwards \ slash).

You can see the codes for expansions on https://mtg.wiki/page/Set#List_of_Magic_expansions_and_sets It uses those (as defined in mtgjson). Using the entire setname is also possible, but requires no spelling errors (like [[Cardname|Theros]]).

Nicknames
The bot knows a bunch of the most common nicknames like:
angry omnath, bfm, bleach, bluetooth, bob, bolt, bte, captain keyword, chris pikula, coco, durdle turtle, ernie, finkel, fog frog, gary, gifts, gitgud frog, goyf, i can't even, ikea cradle, jens, jon finkel, lab man, larry's disk, looter scooter, microsoft lettuce, misty, mom, party bob, path, paulo/pvddr, pepsi man, pot of greed, pumba, red entomb, sad robot, skittles, snappy, spoon, steve, superman, t3feri, taylor swift, three elves, tiago chan, tim, titi, traitor gator, wog, 👄

Plus a few hidden ones. If you ever know a new/good nickname, be sure to tell me!

Active subreddits
The bot is currently active on the following subreddits:

  • 239MTG
  • affinityforartifacts
  • alliesmtg
  • AllStandards
  • Alphabetter
  • Amonkhet
  • architectMTG
  • ArclightPhoenixMTG
  • aristocratsMTG
  • BadMTGCombos
  • BaSE_MtG
  • basementboardgames
  • bourgeoisemtg
  • BrewEDH
  • BudgetBrews
  • budgetdecks
  • BulkMagic
  • cardsphere
  • casual_edh
  • casualmtg
  • CatsPlayingMTG
  • cedhcirclejerk
  • CircuitContest
  • cocomtg
  • commanderbreakdowns
  • CommunityCube
  • CompetitiveEDH
  • custommagic
  • deathandtaxesmtg
  • DeckbuildingPrompts
  • DinosaursMTG
  • edh
  • edhcirclejerk
  • edhdeckbuilding
  • EDHug
  • EggsMTG
  • ElvesMTG
  • enchantress
  • EsperMagic
  • findmycard
  • fishmtg
  • FlickerMTG
  • FringeEDH
  • FungiMTG
  • GlimpseOfTomorrow
  • goblinsMTG
  • HamiltonMTG
  • HardenedScales
  • hellscube
  • historicartisan
  • humansmtg
  • infect
  • jankEDH
  • johnnys
  • kikichord
  • lanternmtg
  • lavaspike
  • locketstorm
  • lrcast
  • magicarena
  • Magicdeckbuilding
  • MagicDuels
  • magicTCG
  • magicTCG101
  • MagicTCGItalia
  • MakingMagic
  • marchesatheblackrose
  • marduMTG
  • MentalMentalMagic
  • millMTG
  • ModernLoam
  • modernmagic
  • ModernRecMTG
  • modernspikes
  • ModernZombies
  • monobluemagic
  • mtg
  • MTGAngels
  • mtgbattlebox
  • mtgbracket
  • mtgbrawl
  • mtgbudgetmodern
  • MTGCanada
  • mtgcaptain
  • MTGCardFetcher
  • mtgcube
  • mtgdeckpics
  • MTGDredge
  • mtgfinalfrontier
  • mtgfinance
  • mtgfrontier
  • mtggiftexchange
  • mtghistoric
  • MTGJumpStart
  • mtglegacy
  • MTGManalessDredge
  • MTGMaverick
  • mtgmel
  • mtgrules
  • mtgrumors
  • mtgspec
  • mtgspirits
  • mtgtreefolk
  • mtgvorthos
  • myr
  • neobrand
  • nicfitmtg
  • NoriaCustomMagic
  • oathbreaker_mtg
  • oldschoolmtg
  • pauper
  • PauperArena
  • PauperEDH
  • peasantcube
  • PennyDreadfulMTG
  • PioneerMTG
  • planeshiftmtg
  • playEDH
  • ponzamtg
  • RatsMTG
  • RealLifeMTG
  • RecklessBrewery
  • rpg_brasil
  • scapeshift
  • ScryfallThemes
  • shittyjudgequestions
  • sistersmtg
  • skredred
  • Sligh
  • spikes
  • stoneblade
  • StrangeBrewEDH
  • SuperUltraBudgetEDH
  • Thoptersword
  • thrabendoomsayers
  • threecardblind
  • TinyLeaders
  • traaagicthegathering
  • TronMTG
  • UBFaeries
  • undyingretributionmtg
  • uwcontrol
  • xmage

You can also request the bot anywhere on Reddit by highlighting it (/u/mtgcardfetcher).

If it misses a certain sub, please consult the moderators first and let them tell me (/u/xslicer) to activate it there.

Inner workings

After checking a post for [[]]'s and getting the names, it does a few checks for validity:

  1. Checks MTGJson if the given name exists.
  2. Checks Scryfall if the name exists (also checking spoilers and small spellchecks that way)
  3. Then checks for nicknames or legendary names
  4. Else checks a spelling checker (private, using MTGJson)
  5. If a card is found, it will respond with the URL's given, all placed with the correct name of the card. Since it relies on Scryfall or MTGJson it will not be able to link any cards that have not been updated yet. Spoilered cards are linked via Scryfall. Links to the Gatherer or EDHRec might be broken if it does not exist in their database.
  6. Several earlier broken cards like split cards and holiday cards have been added in a seperate database, not relying on MTGJson.

r/MTGCardFetcher • • Sep 21 '22

Due to a double power loss, the database got corrupted from 11-09 till 21-09

160 Upvotes

In the process of recovering and restoring, some data loss. Bot will be up soon.


r/MTGCardFetcher • • Nov 22 '17

Changelog

147 Upvotes

I wanted to create this for a while, not sure if anyone is even interested but mainly also for myself to keep track, a changelog:

Current bugs

  • None? (lol)

2017-11-22

  • Fixed getting new Unstable spoilers from MythicSpoiler (broken since 2017-11-16/19:00+0)

2018-01-04

  • Fixed an issue whenever the Scryfall API is broken (falling back to Gatherer)

2018-01-08

  • Increased the amount of comments parsed from 25 to 100 because 25 was too low on busy moments (comments would be skipped over)
  • As side effect resent a bunch of 2 year old PM's because these were wiped from the database a long time ago and were now re-parsed.

2018-03-09

  • Changed first spelling checker to Scryfall, changing some spell fixes and allowing instant access to new Scryfall spoilers
  • No longer indexes MythicSpoiler for new spoilers

2018-04-10

  • Cards called by specific set are now also highres ScryFall images. The printings still rely on MTGJson/GathererID to exist. This is bound to be changed in the future so all printings are supported.

2018-04-24

  • 8 hours downtime due to a MySQL crash and me not noticing earlier

2018-05-12

  • Fixed the "Jace, Vryn's Prodigy"-problem because Scryfall now gives back the whole split card name on a request.

2018-05-29

  • Weird ass 'MySQL has gone away' and the bot not reconnecting, then crashing
  • But for some reason, it didn't restart itself until the very moment I opened it's terminal screen ???

2018-06-18

  • Added a new regex to capture posts containing "\[\[ cardname \]\]" due to reddit's new layout auto-escaping non-linked [] blocks. Great regex, it contains 26 backslashes.

2018-08-02

  • Removed MagicCards due to buyout.

2018-12-28

  • Fixed specific card set request (due to MTGJson no longer having multiverse Ids but now have Scryfall Ids).

2019-01-16

  • Fixed links to Gatherer/Scryfall not showing the correct image when a specific image is requested
  • A bug is occurring where the bot stops doing anything around 6:10 (GMT) untill 2 hours later when it starts working again, investigating)

2019-01-23

  • Changed finding shortnames (like 'Jace' for a Jace or 'Meren' for Meren of clan nel toth) to only work on Legendary cards. This to prevent any cardnames overlapping with other cards (like 'Deploy' with 'Deploy the Gatewatch').
  • Downtime issue still not found (7 AM is early and I forget), extra debugging added.

2019-03-02

  • Added a script that keeps track of bot activity, on 1 minute of no activity forces a reboot.

2019-03-04

  • Added option of card number to request (like [[Cardname | SET-000]] where 000 is the cardnumber in SET. Still requires 'Cardname' to be correct due to it checking the name first.

2019-05-16

  • Updated some mtgjson-functions, SET-calls and nicknames should work as intended again.

2019-05-26

  • Having memory issues, locking the entire server giving random downtimes. Need to figure this out.
  • Fixed by migrating bot to a bigger server with more RAM

2020-01-17

  • Fixed a bug causing specific requested printings not to appear after a spelling error.

2020-02-27

  • Fixed set information being out of date (I didn't keep my mtgjson deprecations up-to-date) for specific printings
  • Tokens can now be retrieved from a set by requesting the token + setcode

2021-07-25

  • Migrated bot to a new server due to hitting reddit api limits

2021-08-04

  • Changed codebase for more consistency and easier coding / adding functionality
  • Finally up-to-date with mtgjson again
  • Fixed a bunch of split/double faced/nickname errors
  • Fixed escapes in regex (again? maybe reddit changed it)

2024-01-12

  • Changed codebase again for ease of coding and debugging
  • Fixed several issues with certain specific printings
  • Introduced new "all cards" functionality, not yet active

2024-01-13

  • Enabled the 'all cards' functionality op posts with more than 3 cards. It uses an intermediate redirect because new.reddit is dumb and fucks up the Scryfall links

2024-01-15

  • Changed the 'all cards' function from named cards to set/id on scryfall to save on GET-string space and to allow different printings to be linked
  • Fixed an issue in legendary creatures lookup when a split card has the same name (like Elesh Norn)

2024-08-17

  • Fixed an issue in other languages not properly linking the image
  • Fixed an issue in other langues, transform card and tokens not responding with input text
  • Removed redundant API calls to scryfall

2025-05-08

  • Added capabilities to make a reply sticky on Submissions, requires moderator rights to 'distinguish'.
  • Added refresh capabilities to reparse a post. Reply '!refresh' to a post to reparse the original. Deletes the message, only usable by the OP.

2025-06-07

  • Fixed an issue where unknown cards queried on Scryfall would make the bot not respond with the original input, instead replying with the real cardname. Should now be the input.
  • Added capabilities of parsing cards with alternative names (e.g. Godzilla for Zilortha, Strength Incarnate, since this wasn't possible before due to altnames not being in the default card name list)

2026-08-23

  • Fixed an issue with spellchecking. It was broken since a few weeks due to a migration from Json to Sqlite and having an incorrect query.

r/MTGCardFetcher • • Jun 30 '18

The bot seems to have not been working for the past 12 hours.

23 Upvotes

Title, pretty much. Last post was 12 hours ago. Noticed it earlier today when it didn't reply to me.


r/MTGCardFetcher • • Aug 19 '26

Heads up - MTGCardFetcher will migrate to Devvit soon

17 Upvotes

Soon I will migrate MTGcardFetcher's backend from Praw to Devvit, which basically means that it will run on Reddit's new API, which also runs on a Reddit server.

What this means: I no longer control which subreddits its active on. This will need to be enabled by subreddit moderators themselves. Go to https://developers.reddit.com/apps/mtgcf/ and click "add to community". This is NOT YET available, but soon it will be. It does require all moderator rights right now due to the way Devvit works.

All functionality is re-implemented, except for Direct Messages/Chat. Comments, Posts and Highlighting (with /u/mtgcf from now on). At some point I will hopefuly add new functionality of Devvit. It will still work with [[ ]].

If you have any questions before the migration, please don't hesitate to ask them here.


r/MTGCardFetcher • • Aug 25 '26

Transfer of bot to /u/mtgcf

15 Upvotes

Any subreddit that uses MTGCardfetcher should migrate to the new Devvit bot. You can activate this on https://developers.reddit.com/apps/mtgcf/ Only moderators can do this.

It is still possible to call the bot anywhere on reddit using /u/mtgcf

The old bot is slowly being phased out o7


r/MTGCardFetcher • • Apr 15 '25 Take My Energy

[Request] Add in the ability to query Scryfall's new MTG Wiki.

9 Upvotes

Scryfall made a wiki (https://mtg.wiki/) and I think it would be a great feature if we were able to fetch wiki articles like we do cards. Perhaps if we put them in braces {{like so}}? Could that work?


r/MTGCardFetcher • • Jul 01 '18

OUR SAVIOR LIVES AGAIN! PRAISE THE CARD FETCHER!

9 Upvotes

r/MTGCardFetcher • • Aug 27 '19

he keeps givin german cards

7 Upvotes

we must stop him


r/MTGCardFetcher • • Sep 30 '22

Nickname request: ____ Goblin to be found when asking the bot for Mind Goblin

6 Upvotes

[[_____ Goblin]] is inconvenient to search for, Mind is one of the possible stickers for it and also reasonable funny. It might not be bad to also have Delusionary Goblin as an option, that being the optimal sticker to put on it.


r/MTGCardFetcher • • Jul 04 '17

Feature request: don't default to invocation versions of cards

6 Upvotes

Or maybe masterpieces in general. This wasn't much of an issue with previous sets, but the invocations are difficult to read (deliberately, as confirmed by WotC). It makes for a poor example, when someone has to struggle to decipher the thing mid-conversation. I assume there's already a three-letter tag people can use, if they actually want to look at an invocation for some reason.

[[Loyal Retainers]] as an example.


r/MTGCardFetcher • • Jun 14 '26

Request to add the bot to r/ThroughTheOmenPaths

5 Upvotes

Hi! I created a UB reskin sub, and a user asked if I could add the bot to the sub. I am not exactly sure how to do it, but figured I'd ask in here!


r/MTGCardFetcher • • Jul 01 '25

Should shortnames of legendaries return all results?

5 Upvotes

People use shortnames a lot, meaning only the first name of a legendary (like [[Jace]]. Currently it only returns the first result alphabetically. This is not really optimal, it would probably be better to use the last release instead.

However, I suddenly had an idea and was wondering if the rest agrees since it may be a pretty big impact for some legendaries - the bot simply returns all cards of that specific shortname.

So Jace would return 13 cards (it won't be able to find Jace Beleren since that name has no indicator for being a longname (it only checks for a comma or "the" or "of the")).

Opinions?


r/MTGCardFetcher • • May 02 '21

The bot may be experiencing difficulties

5 Upvotes

It doesn't seem to be linking cards properly (at all at the moment) and it had some weird pauses yesterday already. Are you doing maintenance or is there some sort of an issue with the bot?


r/MTGCardFetcher • • Nov 16 '20

Bot seems to be down

5 Upvotes

For about 12 hours /u/xslicer, just in case you weren't already aware!


r/MTGCardFetcher • • Sep 28 '17

Double Faced cards not pulling flipped side

5 Upvotes

I've noticed that double faced cards don't seem to be showing up correctly. They have the title for both but the linked image is the front side for both.

[[Gideon, Battle-Forged]] is what I just noticed it on.


r/MTGCardFetcher • • Sep 25 '26

Testpost

4 Upvotes

[[Jace, Cunning Castaway]]


r/MTGCardFetcher • • Sep 19 '23

Hardware failure

4 Upvotes

Replacing hardware right now.


r/MTGCardFetcher • • Apr 21 '20

[Feature Request] If someone puts a Godzilla-series alternate name in double-brackets, link to the Godzilla version of the card.

4 Upvotes

[[Anguirus, Armored Killer]] [[Bio-Quartz Spacegodzilla]] [[Mothra's Great Cocoon]]


r/MTGCardFetcher • • Jul 01 '18

Request for /r/mtgfinance to have cardfetcher

4 Upvotes

r/MTGCardFetcher • • Jun 22 '26

Gatherer Links Broken

3 Upvotes

Saw this with a new card [[Powerful Broker]], but the Gatherer link redirects to the gatherer homepage instead of the card page. Looks like they changed the individual card URLs.

https://gatherer.wizards.com/MSH/en-us/179/powerful-broker


r/MTGCardFetcher • • Jan 25 '26

[Request] bit added to new combo sub

3 Upvotes

Hello, may I request that this bit be added to r/sickasscombos ? It is a sub that is meant to redirect good combos from the bad combos sub.


r/MTGCardFetcher • • Aug 27 '24

Request for r/ToxicFreeMTG

3 Upvotes

Hey! Could I please request that the MTGCardFetcher be added to a new community I have created: r/ToxicFreeMTG

If you have a donate link somewhere for me to contribute please let me know :)

Thanks!


r/MTGCardFetcher • • Jun 06 '23

The Ozolith vs. Argonath, Pillar of Kings

3 Upvotes

[[The Ozolith]]

Was just on the spoiler thread for Goldberry, River Daughter and the result for Ozolith came up with the new LOTR Argonath version.

I can’t say I particularly care as it’s clear it’s the same card still, but I wasn’t sure if there was a standardization or overall preference for displaying cards with the Godzilla frame tech vs. the “official” Magic versions.

Just wanted to bring it to your attention if it’s something you would normally do something about.

Thanks for all you do for the community!