{
    "id": "get_article",
    "name": "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.",
    "version": "2.1.0",
    "effect": "read",
    "generated": false,
    "endpoint": "https://blackorder.io/api/agent/tools/get_article",
    "method": "POST",
    "mcp": {
        "url": "https://blackorder.io/mcp",
        "tool": "get_article"
    },
    "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"
        ]
    },
    "examples": [
        {
            "input": {
                "slug": "agentorder",
                "language": "it"
            },
            "expected": "Article if present; otherwise a not-found tool error. Use search_articles for current identifiers."
        }
    ],
    "fallback": {
        "url": "https://blackorder.io/agents/catalog",
        "text": "https://blackorder.io/llms-full.txt",
        "limitations": "Publisher catalog; automatic compatibility evaluation requires REST or MCP."
    }
}