{
    "schema": "blackorder/mcp-server-card/1",
    "schema_status": "publisher extension",
    "server": {
        "name": "blackorder-catalog",
        "title": "BlackOrder Catalog",
        "version": "2.1.0",
        "websiteUrl": "https://blackorder.io/agents",
        "description": "Read-only catalog of BlackOrder apps and articles, generated from the publisher's own data."
    },
    "endpoint": "https://blackorder.io/mcp",
    "transport": "streamable-http",
    "protocol_versions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
    ],
    "capabilities": {
        "tools": {}
    },
    "session_management": {
        "mode": "stateless",
        "issues_session_ids": false,
        "legacy_initialization": true,
        "modern_discovery": "server/discover"
    },
    "response_modes": [
        "application/json"
    ],
    "authentication": {
        "required": false
    },
    "tools": [
        {
            "name": "consult_resource",
            "title": "Chiedi all’agente del sito",
            "description": "Ask the BlackOrder site agent about its services, apps or articles. It uses DeepSeek to inspect the official catalog and returns recommendations, official images, requirements and source URLs. Read-only; AI commentary is explicitly inferred. Never send secrets, personal details or payment data.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "minLength": 3,
                        "maxLength": 1600
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "it",
                            "en"
                        ],
                        "default": "it"
                    }
                },
                "required": [
                    "query"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "required": [
                    "contract",
                    "status",
                    "answer",
                    "results",
                    "generated_at"
                ],
                "properties": {
                    "contract": {
                        "const": "resource-advisor/0.1"
                    },
                    "status": {
                        "const": "ok"
                    },
                    "answer": {
                        "type": "object"
                    },
                    "results": {
                        "type": "array"
                    },
                    "generated_at": {
                        "type": "string"
                    }
                },
                "additionalProperties": true
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": false,
                "openWorldHint": false
            },
            "_meta": {
                "io.experience/advisor": {
                    "contract": "resource-advisor/0.1",
                    "mcp_url": "https://blackorder.io/mcp",
                    "tool": "consult_resource",
                    "endpoint": "https://blackorder.io/api/agent/consult",
                    "method": "POST",
                    "effect": "read",
                    "description": "A site-operated AI researches official apps, articles and current public service pages and returns recommendations with attributed records. Generated advice is inference, not a verified fact.",
                    "privacy": "Only the submitted question and public catalog are sent to DeepSeek. Do not submit personal or payment data. No conversation history is retained.",
                    "limits": {
                        "max_query_characters": 1600,
                        "max_model_calls": 2
                    },
                    "requires_client_ai_key": false
                }
            }
        },
        {
            "name": "search_site",
            "title": "Search the official site",
            "description": "Search services, Studio, contacts, public pages, applications and articles. For custom development or company questions search here, not only search_apps. Missing results do not prove a service is absent.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "maxLength": 500
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "default": "en"
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 20
                    }
                },
                "required": [
                    "query"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "additionalProperties": true,
                "properties": {
                    "results": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "canonical_url": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "official_page_url": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "title": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "version": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minimum_os": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "architecture": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "price": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "is_free": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "signed": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "notarized": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "facts": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "object",
                                        "required": [
                                            "value",
                                            "source",
                                            "verified_at",
                                            "freshness",
                                            "confidence",
                                            "type"
                                        ],
                                        "properties": {
                                            "value": {},
                                            "source": {
                                                "type": "object",
                                                "required": [
                                                    "url",
                                                    "publisher",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "url": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    },
                                                    "publisher": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    }
                                                }
                                            },
                                            "verified_at": {
                                                "type": "null"
                                            },
                                            "freshness": {
                                                "type": "object",
                                                "properties": {
                                                    "retrieved_at": {
                                                        "type": "string",
                                                        "format": "date-time"
                                                    },
                                                    "max_age_seconds": {
                                                        "type": "integer"
                                                    }
                                                }
                                            },
                                            "confidence": {
                                                "enum": [
                                                    "publisher_declared",
                                                    "unknown"
                                                ]
                                            },
                                            "type": {
                                                "const": "publisher_statement"
                                            },
                                            "verification_scope": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                }
                            },
                            "additionalProperties": true
                        }
                    }
                },
                "required": [
                    "results"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "read_site_page",
            "title": "Read an official public page",
            "description": "Read the current published text of a page by its slug from search_site. Includes content date, hash, headings and truncation flag. No arbitrary URL fetching.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "slug": {
                        "type": "string",
                        "pattern": "^[a-z0-9-]+$",
                        "maxLength": 160
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "default": "en"
                    }
                },
                "required": [
                    "slug"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "required": [
                    "page"
                ],
                "properties": {
                    "page": {
                        "type": "object",
                        "properties": {
                            "canonical_url": {
                                "type": "string",
                                "format": "uri"
                            },
                            "official_page_url": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "title": {
                                "type": "string"
                            },
                            "description": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "version": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "minimum_os": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "architecture": {
                                "type": [
                                    "array",
                                    "null"
                                ],
                                "items": {
                                    "type": "string"
                                }
                            },
                            "price": {
                                "type": [
                                    "number",
                                    "null"
                                ]
                            },
                            "currency": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "is_free": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            },
                            "signed": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            },
                            "notarized": {
                                "type": [
                                    "boolean",
                                    "null"
                                ]
                            },
                            "facts": {
                                "type": "object",
                                "additionalProperties": {
                                    "type": "object",
                                    "required": [
                                        "value",
                                        "source",
                                        "verified_at",
                                        "freshness",
                                        "confidence",
                                        "type"
                                    ],
                                    "properties": {
                                        "value": {},
                                        "source": {
                                            "type": "object",
                                            "required": [
                                                "url",
                                                "publisher",
                                                "type"
                                            ],
                                            "properties": {
                                                "url": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "publisher": {
                                                    "type": "string"
                                                },
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "verified_at": {
                                            "type": "null"
                                        },
                                        "freshness": {
                                            "type": "object",
                                            "properties": {
                                                "retrieved_at": {
                                                    "type": "string",
                                                    "format": "date-time"
                                                },
                                                "max_age_seconds": {
                                                    "type": "integer"
                                                }
                                            }
                                        },
                                        "confidence": {
                                            "enum": [
                                                "publisher_declared",
                                                "unknown"
                                            ]
                                        },
                                        "type": {
                                            "const": "publisher_statement"
                                        },
                                        "verification_scope": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        },
                        "additionalProperties": true
                    }
                },
                "additionalProperties": true
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "search_apps",
            "title": "Search BlackOrder apps",
            "description": "Ranked search over BlackOrder applications. Returns compact records with canonical_url and official_page_url (the page where a person downloads; files are never returned).",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "Free-text query, e.g. \"professional audio editor\"."
                    },
                    "platform": {
                        "type": "string",
                        "enum": [
                            "macOS",
                            "iOS",
                            "iPadOS"
                        ],
                        "description": "Platform filter; BlackOrder publishes macOS, iOS and iPadOS software."
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "audio",
                            "video",
                            "developer-tools",
                            "network",
                            "security",
                            "system",
                            "productivity",
                            "utilities",
                            "weather"
                        ],
                        "description": "App category."
                    },
                    "free": {
                        "type": "boolean",
                        "description": "true = free apps only, false = explicitly paid apps only. Unknown prices match neither filter."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    },
                    "capabilities": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Words that must appear in the app's capabilities (e.g. [\"transcription\"])."
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 50,
                        "default": 10
                    }
                },
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "publisher": {
                        "type": "string"
                    },
                    "source": {
                        "type": "string"
                    },
                    "canonical_domain": {
                        "type": "string"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "language": {
                        "type": "string"
                    },
                    "results": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "canonical_url": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "official_page_url": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "title": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "version": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minimum_os": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "architecture": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "price": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "is_free": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "signed": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "notarized": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "facts": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "object",
                                        "required": [
                                            "value",
                                            "source",
                                            "verified_at",
                                            "freshness",
                                            "confidence",
                                            "type"
                                        ],
                                        "properties": {
                                            "value": {},
                                            "source": {
                                                "type": "object",
                                                "required": [
                                                    "url",
                                                    "publisher",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "url": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    },
                                                    "publisher": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    }
                                                }
                                            },
                                            "verified_at": {
                                                "type": "null"
                                            },
                                            "freshness": {
                                                "type": "object",
                                                "properties": {
                                                    "retrieved_at": {
                                                        "type": "string",
                                                        "format": "date-time"
                                                    },
                                                    "max_age_seconds": {
                                                        "type": "integer"
                                                    }
                                                }
                                            },
                                            "confidence": {
                                                "enum": [
                                                    "publisher_declared",
                                                    "unknown"
                                                ]
                                            },
                                            "type": {
                                                "const": "publisher_statement"
                                            },
                                            "verification_scope": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                }
                            },
                            "additionalProperties": true
                        }
                    }
                },
                "required": [
                    "publisher",
                    "source",
                    "canonical_domain",
                    "results"
                ],
                "additionalProperties": true
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "list_apps",
            "title": "List BlackOrder apps",
            "description": "All BlackOrder applications, optionally filtered by category, platform, price and language of the answer.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "category": {
                        "type": "string",
                        "enum": [
                            "audio",
                            "video",
                            "developer-tools",
                            "network",
                            "security",
                            "system",
                            "productivity",
                            "utilities",
                            "weather"
                        ],
                        "description": "App category."
                    },
                    "platform": {
                        "type": "string",
                        "enum": [
                            "macOS",
                            "iOS",
                            "iPadOS"
                        ],
                        "description": "Platform filter; BlackOrder publishes macOS, iOS and iPadOS software."
                    },
                    "free": {
                        "type": "boolean"
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "publisher": {
                        "type": "string"
                    },
                    "source": {
                        "type": "string"
                    },
                    "canonical_domain": {
                        "type": "string"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "language": {
                        "type": "string"
                    },
                    "results": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "canonical_url": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "official_page_url": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "title": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "version": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minimum_os": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "architecture": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "price": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "is_free": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "signed": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "notarized": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "facts": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "object",
                                        "required": [
                                            "value",
                                            "source",
                                            "verified_at",
                                            "freshness",
                                            "confidence",
                                            "type"
                                        ],
                                        "properties": {
                                            "value": {},
                                            "source": {
                                                "type": "object",
                                                "required": [
                                                    "url",
                                                    "publisher",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "url": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    },
                                                    "publisher": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    }
                                                }
                                            },
                                            "verified_at": {
                                                "type": "null"
                                            },
                                            "freshness": {
                                                "type": "object",
                                                "properties": {
                                                    "retrieved_at": {
                                                        "type": "string",
                                                        "format": "date-time"
                                                    },
                                                    "max_age_seconds": {
                                                        "type": "integer"
                                                    }
                                                }
                                            },
                                            "confidence": {
                                                "enum": [
                                                    "publisher_declared",
                                                    "unknown"
                                                ]
                                            },
                                            "type": {
                                                "const": "publisher_statement"
                                            },
                                            "verification_scope": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                }
                            },
                            "additionalProperties": true
                        }
                    }
                },
                "required": [
                    "publisher",
                    "source",
                    "canonical_domain",
                    "results"
                ],
                "additionalProperties": true
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "get_app_details",
            "title": "Get app details",
            "description": "Full record of one app: description, version, requirements, capabilities, privacy facts, screenshots, official page. Identify it by app_id or slug (e.g. \"peaklab\", \"charlie\", \"onrecord\").",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "app_id": {
                        "type": "string"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                },
                "additionalProperties": true,
                "required": [
                    "canonical_url"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "get_latest_version",
            "title": "Get latest version",
            "description": "Current version, build, release date, minimum macOS and release notes of an app distributed through BlackOrder's signed update channel, plus the official download page.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "app_id": {
                        "type": "string",
                        "description": "App id or slug."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "required": [
                    "app_id"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                },
                "additionalProperties": true,
                "required": [
                    "canonical_url"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "check_compatibility",
            "title": "Check compatibility",
            "description": "Whether an app runs on a given macOS version and CPU architecture.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "app_id": {
                        "type": "string",
                        "description": "App id or slug."
                    },
                    "os": {
                        "type": "string",
                        "description": "macOS version, e.g. \"14.5\"."
                    },
                    "architecture": {
                        "type": "string",
                        "enum": [
                            "arm64",
                            "x86_64"
                        ],
                        "description": "CPU architecture (Apple silicon = arm64)."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "required": [
                    "app_id"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "compatible": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    }
                },
                "additionalProperties": true,
                "required": [
                    "canonical_url"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "search_articles",
            "title": "Search The Dark Codex articles",
            "description": "Ranked search over BlackOrder's blog articles (English and Italian). Each result carries the canonical article URL in the requested language.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string"
                    },
                    "category": {
                        "type": "string",
                        "enum": [
                            "software",
                            "essay"
                        ],
                        "description": "software = article about a BlackOrder app; essay = other writing."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Tags that must all be present."
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 50,
                        "default": 10
                    }
                },
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "publisher": {
                        "type": "string"
                    },
                    "source": {
                        "type": "string"
                    },
                    "canonical_domain": {
                        "type": "string"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "language": {
                        "type": "string"
                    },
                    "results": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "canonical_url": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "official_page_url": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "title": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "version": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "minimum_os": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "architecture": {
                                    "type": [
                                        "array",
                                        "null"
                                    ],
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "price": {
                                    "type": [
                                        "number",
                                        "null"
                                    ]
                                },
                                "currency": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                },
                                "is_free": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "signed": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "notarized": {
                                    "type": [
                                        "boolean",
                                        "null"
                                    ]
                                },
                                "facts": {
                                    "type": "object",
                                    "additionalProperties": {
                                        "type": "object",
                                        "required": [
                                            "value",
                                            "source",
                                            "verified_at",
                                            "freshness",
                                            "confidence",
                                            "type"
                                        ],
                                        "properties": {
                                            "value": {},
                                            "source": {
                                                "type": "object",
                                                "required": [
                                                    "url",
                                                    "publisher",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "url": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    },
                                                    "publisher": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    }
                                                }
                                            },
                                            "verified_at": {
                                                "type": "null"
                                            },
                                            "freshness": {
                                                "type": "object",
                                                "properties": {
                                                    "retrieved_at": {
                                                        "type": "string",
                                                        "format": "date-time"
                                                    },
                                                    "max_age_seconds": {
                                                        "type": "integer"
                                                    }
                                                }
                                            },
                                            "confidence": {
                                                "enum": [
                                                    "publisher_declared",
                                                    "unknown"
                                                ]
                                            },
                                            "type": {
                                                "const": "publisher_statement"
                                            },
                                            "verification_scope": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                }
                            },
                            "additionalProperties": true
                        }
                    }
                },
                "required": [
                    "publisher",
                    "source",
                    "canonical_domain",
                    "results"
                ],
                "additionalProperties": true
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "get_article",
            "title": "Get article",
            "description": "One article by article_id (numeric) or slug, with summary, excerpt, tags, dates, related apps and canonical URLs in English and Italian.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "article_id": {
                        "type": [
                            "string",
                            "integer"
                        ]
                    },
                    "slug": {
                        "type": "string"
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                },
                "additionalProperties": true,
                "required": [
                    "canonical_url"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        },
        {
            "name": "get_official_page",
            "title": "Get official page",
            "description": "The official BlackOrder page (or App Store page) for an app or article, in the requested language. This is where a person reads more and, for apps, decides whether to download. The API never serves files.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "content_id": {
                        "type": "string",
                        "description": "App id/slug or article slug."
                    },
                    "language": {
                        "type": "string",
                        "enum": [
                            "en",
                            "it"
                        ],
                        "description": "Language of the answer and of the pages returned (default en). With \"it\" the text is Italian and canonical_url points to the Italian page.",
                        "default": "en"
                    }
                },
                "required": [
                    "content_id"
                ],
                "additionalProperties": false
            },
            "outputSchema": {
                "type": "object",
                "properties": {
                    "canonical_url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "official_page_url": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "version": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "minimum_os": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "architecture": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "price": {
                        "type": [
                            "number",
                            "null"
                        ]
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "is_free": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "signed": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "notarized": {
                        "type": [
                            "boolean",
                            "null"
                        ]
                    },
                    "facts": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "object",
                            "required": [
                                "value",
                                "source",
                                "verified_at",
                                "freshness",
                                "confidence",
                                "type"
                            ],
                            "properties": {
                                "value": {},
                                "source": {
                                    "type": "object",
                                    "required": [
                                        "url",
                                        "publisher",
                                        "type"
                                    ],
                                    "properties": {
                                        "url": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "publisher": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "verified_at": {
                                    "type": "null"
                                },
                                "freshness": {
                                    "type": "object",
                                    "properties": {
                                        "retrieved_at": {
                                            "type": "string",
                                            "format": "date-time"
                                        },
                                        "max_age_seconds": {
                                            "type": "integer"
                                        }
                                    }
                                },
                                "confidence": {
                                    "enum": [
                                        "publisher_declared",
                                        "unknown"
                                    ]
                                },
                                "type": {
                                    "const": "publisher_statement"
                                },
                                "verification_scope": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                },
                "additionalProperties": true,
                "required": [
                    "canonical_url"
                ]
            },
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            }
        }
    ],
    "limits": {
        "request_bytes": 65536,
        "tool_arguments_bytes": 12000,
        "catalog_cache_seconds": 60,
        "advisor": {
            "max_query_characters": 1600,
            "max_model_calls": 2
        },
        "rate_limit": "HTTP 429; publisher operational limits apply.",
        "browser_advisor_origins": [
            "https://blackorder.io",
            "https://www.blackorder.io"
        ]
    },
    "fallback": {
        "rest": "https://blackorder.io/api/agent/openapi",
        "html": "https://blackorder.io/agents/catalog",
        "text": "https://blackorder.io/llms-full.txt"
    },
    "status_url": "https://blackorder.io/agents/status"
}