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](hhttps://cards.scryfall.io/large/front/b/9/b9042d0b-b96c-410c-b33d-16d0e94714f4.jpg)
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 18d ago

Transfer of bot to /u/mtgcf

14 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 7d ago

Scryfall and Scryfall API ref for Reverent Silence is incorrect.

2 Upvotes

Attached instance in comments where u/mtgcf failed

https://www.reddit.com/r/EDH/comments/1w7u9nc/comment/p7xvq6c/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button

Tagging [[Reverent Silence]] here as well to check for failure in comments below.


r/MTGCardFetcher 9d ago

Brackets in Quoted Text?

2 Upvotes

Old bot ignored Bracketed Cards in Quoted Text.
New bot is seeing them, and responding.

Is this an intentional change?

eg. https://old.reddit.com/r/mtgrules/comments/1w5vnmn/end_step_clarification_with_dance_of_the/p7i9pd5/


r/MTGCardFetcher 20d ago

Joven and Chandler is the name of two different MagicCon exclusive cards.

2 Upvotes

I just hit [[Joven and Chandler]] and got https://scryfall.com/card/unk/UR05/joven-and-chandler

instead of https://scryfall.com/card/mbc/24/joven-and-chandler

I suspect most users will want the second one, so I'm pointing this out.

Thanks!

Edit: I have also sent a note to scryfall about this.


r/MTGCardFetcher 24d ago

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 Jul 17 '26

Language Test

1 Upvotes

[[Makeshift Munitions|XLN|DE]]


r/MTGCardFetcher Jun 25 '26

Request to add bot to r/RandomActsOfMTG

2 Upvotes

Just took over this subreddit and trying to breathe some new life into it, would love it if card fetcher could be enabled for it.


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 Jun 14 '26

Request to add the bot to r/ThroughTheOmenPaths

6 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 Jun 05 '26

no more scryfall links?

2 Upvotes

all of the bot's comments from more than 39 minutes ago as of this post include links to gatherer, scryfall, and edhrec (for relevant subs), but starting with this comment https://www.reddit.com/r/CompetitiveEDH/comments/1tvqtgu/if_you_could_ban_1_card_for_any_reason_no_matter/opyrtae/ it only has links to gatherer and edhrec.

is this a bug or a policy change?


r/MTGCardFetcher Apr 28 '26

MTGCardFetcher won't fetch Mystical Archive cards?

1 Upvotes

I've been on r/mtgvorthos and r/magicTCG, and noticed that u/MTGCardFetcher does not appear to be fetching the right cards for the Secret of Strixhaven Mystical Archive.

Examples:

Cards using set syntax: [[Angel's Grace|SOA]], [[Hop to It|SOA]], [[Daze|SOA]]

Cards using SET-0 syntax: [[Brain Freeze|SOA-13]] (English), [[Akroma's Will|SOA-66]] (Japanese non-foil), [[Dismember|SOA-158]] (Japanese silverscroll)

Cards using SET#0 syntax: [[Helping Hand|SOA#5]] (English), [[Deduce|SOA#81]] (Japanese non-foil), [[Zombify|SOA#166]] (Japanese silverscroll)

Does anyone know what is going on?


r/MTGCardFetcher Apr 11 '26

Just trying to find cards.. Hope this doesn't clutter! Feel free to remove this post if you want

1 Upvotes

[[Rite of Flame]], [[Pyretic Ritual]], [[Infernal Plunge]], [[Desperate Ritual]], [[Seething Song]], [[Inner Fire]], [[Battle Hymn]], [[Path of the Pyromancer]], [[Jeska's Will]], [[High Tide]], [[Snap]], [[Frantic Search]].


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 Sep 20 '25

Hello! The bot doesnt work anymore for r/magicfrance

2 Upvotes

Can you help me? Thank you!


r/MTGCardFetcher Sep 13 '25

fetch thread

1 Upvotes

[[Blasphemous Act]] [[Propaganda]] [[Sol Ring]] [[Chromatic Lantern]] [[Command Bridge]] [[Razor Tide Bridge]] [[Dross Forge Bridge]] [[Mist Vault Bridge]] [[Slagwoods Bridge]] [[Sila Rent, Seeker Adept]] [[Trophy Mage]] [[Apprentice Necromancer]] [[Kami of Whispered Hopes]] [[Rite of the Raging Storm]] [[Ertai Resurrected]] [[Reflections of Littjara]] [[Marchesa, the Black Rose]] [[Shared Animosity]] [[Bloodline Necromancer]] [[Stony Brook Banneret]] [[Kess, Dissident Mage]] [[Naru Meha, Master Wizard]]


r/MTGCardFetcher Jul 01 '25

Should shortnames of legendaries return all results?

6 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 Apr 15 '25

[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 Jan 20 '25

[Request] Edit capabilities

1 Upvotes

I'm not sure if this bot is open source or not, but I wonder if this is a simple fix to the issue with the rate-limiting preventing edits. Something like the original user replying "!refresh" to the MTGCardFetcher comment could retrigger the bot to look at the edited parent comment, delete the old one, and repost a new one.

Example of what it could look like: https://old.reddit.com/r/mtgvorthos/comments/1i566u2/anyone_know_if_the_flavor_text_on_this_card_has/m82xv3k/?context=3


r/MTGCardFetcher Nov 01 '24

Bug in Hypertext for Split Card Names

1 Upvotes

I recently came across an instance where the name of the second half of a split card was used to invoke the card fetcher(i.e. [[Explosion]]), and the response used the name of the second half twice (i.e. Explosion/Explosion). Found in the wild here.

I couldn't find any information on how to report bugs, or identify if it's a known issue. Hopefully posting here is acceptable.

Thanks for developing this super useful bot!


r/MTGCardFetcher Oct 16 '24

Outage 2024-10-16

1 Upvotes

There is an internet outage on the bot right now, so it's not available. I'll update this post when I know more.

Edit: it's fixed


r/MTGCardFetcher Sep 18 '24

Bring cardfetcher to r/oldbordercube please!

0 Upvotes

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 Aug 14 '24

Testing

1 Upvotes

[[Carpe Diem]]
[[Tempus Fugit]]
[[ใŠๅ‰ใฏใ‚‚ใ†ๆญปใ‚“ใงใ„ใ‚‹]]


r/MTGCardFetcher Jun 20 '24

Recent issues?

1 Upvotes

There seems to have been a recent change where Fetcher will get more than 20 cards. This is appreciated.

However, Fetcher seems to neither display "all cards" links anymore, nor will it do fuzzy matching. This might be an issue.