{"ok":true,"site":{"host":"magicbrain.es","url":"https://magicbrain.es/","type":"live","desc":"Organize your Magic: The Gathering collection, explore cards and editions, and understand value with clear market context.","tools":[{"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},"executable":true,"outputSchema":{"type":"object","properties":{"destination":{"type":"string","description":"The validated destination ID."},"path":{"type":"string","description":"The internal path opened in Magic Brain."}},"required":["destination","path"],"additionalProperties":false},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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}}},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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}}},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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}}},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"$ref":"#/$defs/__schema0"},"attribution":{"type":"object","properties":{"service":{"type":"string","const":"Magic Brain Public API"},"source_url":{"type":"string","format":"uri"},"fetched_at":{"type":"string"},"notice":{"type":"string"}},"required":["service","source_url","fetched_at","notice"],"additionalProperties":false},"request_id":{"type":"string"}},"required":["data","attribution"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"score":{"type":"number"},"excerpt":{"type":"string","maxLength":602},"citation":{"type":"object","properties":{"ruleNumber":{"type":"string"},"glossaryTerm":{"type":"string"},"section":{"type":"string"},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sourceUrl":{"type":"string","format":"uri"}},"required":["section","page","sourceUrl"],"additionalProperties":false}},"required":["score","excerpt","citation"],"additionalProperties":false}},"source":{"type":"object","properties":{"version":{"type":"string"},"effectiveDate":{"type":"string"},"fetchedAt":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"rulesPageUrl":{"type":"string","format":"uri"},"sha256":{"type":"string"},"matchesPinnedOfficialSource":{"type":"boolean"},"freshnessNotice":{"type":"string"},"attribution":{"type":"string"}},"required":["version","effectiveDate","fetchedAt","sourceUrl","rulesPageUrl","sha256","matchesPinnedOfficialSource","freshnessNotice","attribution"],"additionalProperties":false}},"required":["results","source"],"additionalProperties":false},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string"},"officialRules":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"score":{"type":"number"},"excerpt":{"type":"string","maxLength":602},"citation":{"type":"object","properties":{"ruleNumber":{"type":"string"},"glossaryTerm":{"type":"string"},"section":{"type":"string"},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sourceUrl":{"type":"string","format":"uri"}},"required":["section","page","sourceUrl"],"additionalProperties":false}},"required":["score","excerpt","citation"],"additionalProperties":false}},"explanatorySynthesis":{"type":"object","properties":{"authority":{"type":"string","const":"non-authoritative"},"text":{"type":"string"}},"required":["authority","text"],"additionalProperties":false},"source":{"type":"object","properties":{"version":{"type":"string"},"effectiveDate":{"type":"string"},"fetchedAt":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"rulesPageUrl":{"type":"string","format":"uri"},"sha256":{"type":"string"},"matchesPinnedOfficialSource":{"type":"boolean"},"freshnessNotice":{"type":"string"},"attribution":{"type":"string"}},"required":["version","effectiveDate","fetchedAt","sourceUrl","rulesPageUrl","sha256","matchesPinnedOfficialSource","freshnessNotice","attribution"],"additionalProperties":false}},"required":["question","officialRules","explanatorySynthesis","source"],"additionalProperties":false},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"results":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"topic":{"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"]},"status":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"statement":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"citations":{"minItems":1,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["label","url"],"additionalProperties":false}},"score":{"type":"number"}},"required":["id","topic","status","statement","keywords","citations","score"],"additionalProperties":false}},"taxonomy":{"type":"object","propertyNames":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"additionalProperties":{"type":"string"},"required":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"canonicalDocument":{"type":"string","format":"uri"},"retrievalNotice":{"type":"string"}},"required":["query","results","taxonomy","canonicalDocument","retrievalNotice"],"additionalProperties":false},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"topics":{"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"]}},"results":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"topic":{"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"]},"status":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"statement":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"citations":{"minItems":1,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["label","url"],"additionalProperties":false}},"score":{"type":"number"}},"required":["id","topic","status","statement","keywords","citations","score"],"additionalProperties":false}},"taxonomy":{"type":"object","propertyNames":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"additionalProperties":{"type":"string"},"required":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"canonicalDocument":{"type":"string","format":"uri"},"retrievalNotice":{"type":"string"}},"required":["topics","results","taxonomy","canonicalDocument","retrievalNotice"],"additionalProperties":false},"handlerField":"execute","page":"/"},{"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"]},"executable":true,"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string"},"evidence":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"topic":{"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"]},"status":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"statement":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"citations":{"minItems":1,"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["label","url"],"additionalProperties":false}},"score":{"type":"number"}},"required":["id","topic","status","statement","keywords","citations","score"],"additionalProperties":false}},"answerInstructions":{"type":"array","items":{"type":"string"}},"taxonomy":{"type":"object","propertyNames":{"type":"string","enum":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"additionalProperties":{"type":"string"},"required":["shipped_fact","operating_principle","hypothesis","roadmap_option","unknown_not_measured"]},"canonicalDocument":{"type":"string","format":"uri"},"retrievalNotice":{"type":"string"}},"required":["question","evidence","answerInstructions","taxonomy","canonicalDocument","retrievalNotice"],"additionalProperties":false},"handlerField":"execute","page":"/"}],"category":"AI & Agents","favicon":"/favicons/magicbrain.es.png","apiSurface":"spec","toolCount":19}}