Tool tree
Organize your Magic: The Gathering collection, explore cards and editions, and understand value with clear market context.
Implementation
gradeNot graded
gradeNot graded
navigate_magic_brainAction
Open a named Magic Brain page. Use the remote research tools to retrieve card or market data.
View tool JSON
{
"name": "navigate_magic_brain",
"kind": "act",
"impl": "imperative",
"description": "Open a named Magic Brain page. Use the remote research tools to retrieve card or market data.",
"inputSchema": {
"type": "object",
"properties": {
"destination": {
"type": "string",
"enum": [
"overview",
"market",
"market_movers",
"latest-set-watch",
"portfolio",
"inventory",
"discover",
"watchlist",
"reserved-list",
"brain",
"signals",
"analyst",
"predict",
"settings",
"developers"
],
"description": "overview: Open the Magic Brain overview dashboard. market: Browse market movements and pricing activity. market_movers: Open the public daily ranking of the top 50 Magic card gainers and losers. latest-set-watch: Review opportunities in the latest Magic set. portfolio: Open the signed-in user's collection portfolio. inventory: Manage the signed-in user's card inventory. discover: Discover cards using Magic Brain filters. watchlist: Open the signed-in user's card watchlist. reserved-list: Explore Reserved List cards. brain: Open Magic Brain's research workspace. signals: Review market signals. analyst: Open the price analyst. predict: Open price prediction tools. settings: Open account and application settings. developers: Open API and MCP developer resources."
}
},
"required": [
"destination"
],
"additionalProperties": false
},
"page": "/"
}search_cardsAnswer
Search Magic Brain's public card catalogue by name or text, with optional set, color, rarity, and type filters. Use this to discover card IDs before requesting details or prices. Returns a bounded cursor-paginated page and never accesses user collections.
View tool JSON
{
"name": "search_cards",
"kind": "answer",
"impl": "imperative",
"description": "Search Magic Brain's public card catalogue by name or text, with optional set, color, rarity, and type filters. Use this to discover card IDs before requesting details or prices. Returns a bounded cursor-paginated page and never accesses user collections.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Card name or text"
},
"set_code": {
"type": "string",
"pattern": "^[a-z0-9]{2,8}$"
},
"rarity": {
"type": "string",
"enum": [
"common",
"uncommon",
"rare",
"mythic",
"special",
"bonus"
]
},
"language": {
"type": "string",
"minLength": 2,
"maxLength": 10
},
"cursor": {
"type": "string",
"maxLength": 512
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"query"
]
},
"page": "/"
}get_cardAnswer
Get public catalogue details for one Magic card by ID, including printing and set metadata when available. Does not return ownership, watchlist, portfolio, or user data.
View tool JSON
{
"name": "get_card",
"kind": "answer",
"impl": "imperative",
"description": "Get public catalogue details for one Magic card by ID, including printing and set metadata when available. Does not return ownership, watchlist, portfolio, or user data.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Magic Brain or canonical card identifier"
}
},
"required": [
"card_id"
]
},
"page": "/"
}get_latest_pricesAnswer
Get the latest available public market prices for up to 100 card IDs in one read-only request. Price records preserve the API's source, observation time, currency, and finish metadata and are not financial advice.
View tool JSON
{
"name": "get_latest_prices",
"kind": "answer",
"impl": "imperative",
"description": "Get the latest available public market prices for up to 100 card IDs in one read-only request. Price records preserve the API's source, observation time, currency, and finish metadata and are not financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"card_ids": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Magic Brain or canonical card identifier"
}
}
},
"required": [
"card_ids"
]
},
"page": "/"
}get_price_historyAnswer
Get bounded public historical price observations for one card and date range. Use daily or weekly intervals; the maximum range is 366 days. Results are market observations, not investment guarantees.
View tool JSON
{
"name": "get_price_history",
"kind": "answer",
"impl": "imperative",
"description": "Get bounded public historical price observations for one card and date range. Use daily or weekly intervals; the maximum range is 366 days. Results are market observations, not investment guarantees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Magic Brain or canonical card identifier"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"finish": {
"default": "all",
"type": "string",
"enum": [
"all",
"nonfoil",
"foil"
]
}
},
"required": [
"card_id",
"start_date",
"end_date"
]
},
"page": "/"
}get_market_moversAnswer
Get a public, read-only ranking of Magic: The Gathering card printings with the largest observed price gains or declines over 1, 7, 30, or 90 days. Returns up to 50 cards with source dates and is not financial advice.
View tool JSON
{
"name": "get_market_movers",
"kind": "answer",
"impl": "imperative",
"description": "Get a public, read-only ranking of Magic: The Gathering card printings with the largest observed price gains or declines over 1, 7, 30, or 90 days. Returns up to 50 cards with source dates and is not financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"direction": {
"default": "gainers",
"type": "string",
"enum": [
"gainers",
"losers"
]
},
"days": {
"default": 7,
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 90
}
]
},
"set_code": {
"type": "string",
"pattern": "^[a-z0-9]{2,8}$"
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
}
},
"page": "/"
}list_setsAnswer
List normalized public Magic set metadata, optionally filtering by name/code, set type, release dates, and tabletop availability. Results are cursor-paginated and bounded.
View tool JSON
{
"name": "list_sets",
"kind": "answer",
"impl": "imperative",
"description": "List normalized public Magic set metadata, optionally filtering by name/code, set type, release dates, and tabletop availability. Results are cursor-paginated and bounded.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"tabletop_only": {
"default": true,
"type": "boolean"
},
"cursor": {
"type": "string",
"maxLength": 512
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 50
}
}
},
"page": "/"
}get_latest_set_opportunitiesAnswer
Get Magic Brain's transparent, read-only ranking of cards in the newest released tabletop expansion, or a requested set. Returns bounded signals such as momentum, stability, drawdown, risk, confidence, and rationale. These are research indicators, not financial advice.
View tool JSON
{
"name": "get_latest_set_opportunities",
"kind": "answer",
"impl": "imperative",
"description": "Get Magic Brain's transparent, read-only ranking of cards in the newest released tabletop expansion, or a requested set. Returns bounded signals such as momentum, stability, drawdown, risk, confidence, and rationale. These are research indicators, not financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"set_code": {
"type": "string",
"pattern": "^[a-z0-9]{2,8}$"
},
"minimum_confidence": {
"default": 0,
"type": "number",
"minimum": 0,
"maximum": 1
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 25
}
}
},
"page": "/"
}predict_set_growthAction
Calculate a transparent, read-only growth scenario for a requested set, or the default eligible set, using bounded assumptions and observed market evidence. Forecast ranges and benchmark comparisons are illustrative research outputs, not guarantees, executable prices, or financial advice.
View tool JSON
{
"name": "predict_set_growth",
"kind": "act",
"impl": "imperative",
"description": "Calculate a transparent, read-only growth scenario for a requested set, or the default eligible set, using bounded assumptions and observed market evidence. Forecast ranges and benchmark comparisons are illustrative research outputs, not guarantees, executable prices, or financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"set_code": {
"type": "string",
"pattern": "^[a-z0-9]{2,8}$"
},
"target": {
"default": "sp500",
"type": "string",
"enum": [
"inflation",
"sp500",
"extreme"
]
},
"horizon_months": {
"default": 24,
"anyOf": [
{
"type": "number",
"const": 12
},
{
"type": "number",
"const": 24
},
{
"type": "number",
"const": 36
}
]
},
"demand": {
"default": 3,
"type": "integer",
"minimum": 1,
"maximum": 5
},
"scarcity": {
"default": 3,
"type": "integer",
"minimum": 1,
"maximum": 5
},
"reprint_resilience": {
"default": 3,
"type": "integer",
"minimum": 1,
"maximum": 5
}
},
"additionalProperties": false
},
"page": "/"
}build_portfolio_scenarioAction
Build a professional, bounded portfolio for one Magic edition using Magic Brain's machine-learning opportunity signals. Returns card allocations, quantities, model scores, confidence, rationale, and unallocated budget. The scenario is read-only and never saved; it omits liquidity, inventory, fees, taxes, shipping, condition, language, and execution-price guarantees and is not financial advice.
View tool JSON
{
"name": "build_portfolio_scenario",
"kind": "act",
"impl": "imperative",
"description": "Build a professional, bounded portfolio for one Magic edition using Magic Brain's machine-learning opportunity signals. Returns card allocations, quantities, model scores, confidence, rationale, and unallocated budget. The scenario is read-only and never saved; it omits liquidity, inventory, fees, taxes, shipping, condition, language, and execution-price guarantees and is not financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"set_code": {
"type": "string",
"pattern": "^[a-z0-9]{2,8}$"
},
"budget_eur": {
"type": "number",
"minimum": 25,
"maximum": 1000000
},
"risk": {
"type": "string",
"enum": [
"preservation",
"conservative",
"balanced",
"growth",
"aggressive"
]
},
"max_positions": {
"default": 8,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"set_code",
"budget_eur",
"risk"
],
"additionalProperties": false
},
"page": "/"
}get_latest_market_briefAnswer
Retrieve the latest immutable Magic Brain market brief derived from stored market observations. This is a deterministic market-data summary, not external reporting, a live quote, a recommendation, or financial advice; preserve its data date, methodology, freshness, and liquidity caveats.
View tool JSON
{
"name": "get_latest_market_brief",
"kind": "answer",
"impl": "imperative",
"description": "Retrieve the latest immutable Magic Brain market brief derived from stored market observations. This is a deterministic market-data summary, not external reporting, a live quote, a recommendation, or financial advice; preserve its data date, methodology, freshness, and liquidity caveats.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"page": "/"
}list_market_briefsAnswer
List a bounded archive of immutable Magic Brain market briefs derived from stored price observations. Archive entries are deterministic research snapshots rather than external news or executable market quotes, and they never include private account, portfolio, or watchlist data.
View tool JSON
{
"name": "list_market_briefs",
"kind": "answer",
"impl": "imperative",
"description": "List a bounded archive of immutable Magic Brain market briefs derived from stored price observations. Archive entries are deterministic research snapshots rather than external news or executable market quotes, and they never include private account, portfolio, or watchlist data.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 30
}
},
"additionalProperties": false
},
"page": "/"
}get_market_brief_by_dateAnswer
Retrieve one immutable deterministic market brief for an exact market-data date. Preserve its provenance, coverage, freshness, and liquidity caveats; it is not external news or financial advice.
View tool JSON
{
"name": "get_market_brief_by_date",
"kind": "answer",
"impl": "imperative",
"description": "Retrieve one immutable deterministic market brief for an exact market-data date. Preserve its provenance, coverage, freshness, and liquidity caveats; it is not external news or financial advice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"date"
],
"additionalProperties": false
},
"page": "/"
}search_opportunity_graphAnswer
Search the public deterministic Opportunity Graph and retrieve bounded nodes, weighted neighbours, similarity reasons, clusters, methodology, and market-data date. Similarity is research context, not a recommendation.
View tool JSON
{
"name": "search_opportunity_graph",
"kind": "answer",
"impl": "imperative",
"description": "Search the public deterministic Opportunity Graph and retrieve bounded nodes, weighted neighbours, similarity reasons, clusters, methodology, and market-data date. Similarity is research context, not a recommendation.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"focus_card_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"limit": {
"default": 48,
"type": "integer",
"minimum": 12,
"maximum": 80
}
},
"additionalProperties": false
},
"page": "/"
}search_rulesAnswer
Search a pinned local lexical index of the official Magic: The Gathering Comprehensive Rules and glossary. Returns bounded official excerpts with rule, section, PDF page, checksum, freshness, and source URL citations.
View tool JSON
{
"name": "search_rules",
"kind": "answer",
"impl": "imperative",
"description": "Search a pinned local lexical index of the official Magic: The Gathering Comprehensive Rules and glossary. Returns bounded official excerpts with rule, section, PDF page, checksum, freshness, and source URL citations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 300
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 10
},
"max_excerpt_chars": {
"default": 360,
"type": "integer",
"minimum": 80,
"maximum": 600
},
"include_glossary": {
"default": true,
"type": "boolean"
}
},
"required": [
"query"
]
},
"page": "/"
}ask_rulesAction
Retrieve official Magic Comprehensive Rules evidence for a rules question. Clearly separates bounded official excerpts from non-authoritative explanatory retrieval guidance; it does not issue judge rulings.
View tool JSON
{
"name": "ask_rules",
"kind": "act",
"impl": "imperative",
"description": "Retrieve official Magic Comprehensive Rules evidence for a rules question. Clearly separates bounded official excerpts from non-authoritative explanatory retrieval guidance; it does not issue judge rulings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"question": {
"type": "string",
"minLength": 5,
"maxLength": 500
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 10
},
"max_excerpt_chars": {
"default": 360,
"type": "integer",
"minimum": 80,
"maximum": 600
},
"include_glossary": {
"default": true,
"type": "boolean"
}
},
"required": [
"question"
]
},
"page": "/"
}search_product_knowledgeAnswer
Search the canonical, deterministic Magic Brain product/business knowledge base. Returns bounded source-cited statements with explicit epistemic status for positioning, moat, users, metrics, monetization, trust, risk, incidents, growth, liquidity, signals, and adjacent TCG diligence.
View tool JSON
{
"name": "search_product_knowledge",
"kind": "answer",
"impl": "imperative",
"description": "Search the canonical, deterministic Magic Brain product/business knowledge base. Returns bounded source-cited statements with explicit epistemic status for positioning, moat, users, metrics, monetization, trust, risk, incidents, growth, liquidity, signals, and adjacent TCG diligence.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 500
},
"topics": {
"maxItems": 11,
"type": "array",
"items": {
"type": "string",
"enum": [
"positioning",
"users_and_alternatives",
"differentiation_and_moat",
"metrics_and_demand",
"monetization",
"provenance_and_trust",
"regulatory_and_risk",
"liquidity_and_signals",
"incidents_and_corrections",
"growth",
"adjacent_tcgs"
]
}
},
"statuses": {
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"shipped_fact",
"operating_principle",
"hypothesis",
"roadmap_option",
"unknown_not_measured"
]
}
},
"limit": {
"default": 8,
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"required": [
"query"
]
},
"page": "/"
}get_product_contextAnswer
Retrieve a bounded canonical evidence bundle for one or more Magic Brain diligence topics. Use it for broad product or business analysis where all returned claims must retain their shipped fact, operating principle, hypothesis, roadmap option, or unknown/not measured status.
View tool JSON
{
"name": "get_product_context",
"kind": "answer",
"impl": "imperative",
"description": "Retrieve a bounded canonical evidence bundle for one or more Magic Brain diligence topics. Use it for broad product or business analysis where all returned claims must retain their shipped fact, operating principle, hypothesis, roadmap option, or unknown/not measured status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"topics": {
"minItems": 1,
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"positioning",
"users_and_alternatives",
"differentiation_and_moat",
"metrics_and_demand",
"monetization",
"provenance_and_trust",
"regulatory_and_risk",
"liquidity_and_signals",
"incidents_and_corrections",
"growth",
"adjacent_tcgs"
]
}
},
"statuses": {
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"shipped_fact",
"operating_principle",
"hypothesis",
"roadmap_option",
"unknown_not_measured"
]
}
},
"limit": {
"default": 12,
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"required": [
"topics"
]
},
"page": "/"
}ask_product_questionAction
Retrieve source-cited canonical evidence for a Magic Brain product or business question without calling another LLM. The host should synthesize the answer, preserve every epistemic status, state unknowns directly, and avoid unsupported metrics or superiority claims.
View tool JSON
{
"name": "ask_product_question",
"kind": "act",
"impl": "imperative",
"description": "Retrieve source-cited canonical evidence for a Magic Brain product or business question without calling another LLM. The host should synthesize the answer, preserve every epistemic status, state unknowns directly, and avoid unsupported metrics or superiority claims.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"request_summary": {
"description": "Optional short summary of why the user requested this tool call. Paraphrase the intent; do not include the original prompt, personal data, credentials, or secrets.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"request_context": {
"description": "Optional privacy-safe metadata inferred from the request. Do not copy the original prompt or include personal data, credentials, secrets, free-form notes, or identifiers.",
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"research",
"compare",
"monitor",
"manage_collection",
"manage_watchlist",
"developer",
"rules",
"other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es",
"other"
]
},
"output_format": {
"type": "string",
"enum": [
"answer",
"list",
"table",
"analysis",
"action"
]
},
"subject": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"intent"
],
"additionalProperties": false
},
"question": {
"type": "string",
"minLength": 5,
"maxLength": 800
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"required": [
"question"
]
},
"page": "/"
}