mtg-mcp-server: Instructions file for Claude Code

CLAUDE.md

mtg-mcp-server CLAUDE.md is an instructions file for Claude Code from Cladios34/mtg-mcp-server. It costs 5,251 tokens per session, scanned A, original, MIT.

Project instructions for an MCP server that gives AI assistants Magic: The Gathering data from several external sources. MCP is a way for software tools to provide data and actions to AI assistants.

In plain words
What is it for?
Use it to install, lint, type-check, test, and develop the Python server and its integrations with Scryfall, Commander Spellbook, 17Lands, and EDHREC.
Why use it?
It gives agents the project’s technology choices, setup commands, quality checks, and testing levels so changes can be verified consistently.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions subagents.

This is Cladios34/mtg-mcp-server's own configuration. It tells Claude Code how to work on mtg-mcp-server itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything mtg-mcp-server configures →

Reuse

Borrowing it

Nothing to install: this file belongs to Cladios34/mtg-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Cladios34/mtg-mcp-server/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/Cladios34/mtg-mcp-server

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mtg-mcp-server CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/cladios34/mtg-mcp-server/claude-md.svg)](https://agentmods.dev/instructions/cladios34/mtg-mcp-server/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/cladios34/mtg-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/cladios34/mtg-mcp-server/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 5,251 This file is loaded in full into every session.
When invoked 5,251 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.05251 $0.05251
Opus 5 $0.02625 $0.02625
Sonnet 5 $0.01050 $0.01050
Haiku 4.5 $0.00525 $0.00525

Measured 7d ago against content hash 40d6166901b3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

mtg-mcp-server CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 198 lines

How it starts

The opening of the file, as written. The whole thing — 198 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MTG MCP Server

Unified MCP server providing Magic: The Gathering data to AI assistants. Composes Scryfall, Commander Spellbook, 17Lands, and EDHREC into one server using FastMCP 3.x's provider/mount architecture.

Stack

Python 3.12+ · FastMCP 3.2.x · httpx · Pydantic v2 · structlog Tooling: mise · uv · ruff · ty · pytest · respx

Prerequisites: mise must be installed. Then mise install gets everything else.

Commands

mise run setup          # Install deps, create venv
mise run check          # Quality gate: lint + typecheck + all tests except live
mise run check:quick    # Fast gate: lint + typecheck + only tests affected by recent changes
mise run check:full     # Complete gate: lint + typecheck + all tests INCLUDING live
mise run test           # All tests except live, with coverage
mise run test:quick     # Only tests affected by recent changes (fastest iteration)
mise run test:unit      # Unit tests only (services + providers)
mise run test:integration # Integration tests (fixture-mocked, cross-component)
mise run test:live      # Live smoke tests (real server + real APIs, ~60s)
mise run lint           # ruff check + ruff format --check
mise run typecheck      # ty check
mise run dev            # fastmcp dev inspector (MCP Inspector on :6274)
mise run serve          # Run server via stdio
mise run fix            # Auto-fix lint and format issues

Testing strategy

Four test tiers, ordered by speed. Use the fastest tier that covers your change:

Tier Command Speed When to use
Quick mise run test:quick ~5s* Active iteration — only runs tests affected by your changes (pytest-testmon)
Integration mise run test:integration ~2s Cross-component verification — full orchestrator with fixture-mocked backends
Unit mise run test:unit ~2.5min Focused component testing — services + providers only
Live mise run test:live ~1-2min Real-world smoke test — starts real server, hits real APIs
Fast gate mise run check:quick ~10s* Quick validation — lint + typecheck + affected tests only
Quality gate mise run check ~3min Before commits — lint + typecheck + all tests except live
Complete gate mise run check:full ~4-5min Maximum confidence — full gate + live smoke tests. CI runs this on PRs

Read the full file on GitHub · 198 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 198 lines · 5,251 tokens per session scan A 40d6166901b3

Subscribe to this mod's changes

mtg-mcp-server CLAUDE.md is an instructions file published in the GitHub repository Cladios34/mtg-mcp-server (0 stars, last pushed 1mo ago), licensed MIT. It adds 5,251 tokens to every session, about $0.0263 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens