{
    "data": {
        "service": "FOSSHunter public agent discovery",
        "description": "Curated directory of open-source tools with point-in-time GitHub repository metrics. All endpoints are read-only, unauthenticated, and citation-first.",
        "endpoints": [
            {
                "method": "GET",
                "path": "/api/public/v1/ai/discovery",
                "description": "This discovery document."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/catalog/stats",
                "description": "Catalog statistics and freshness signals."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/tools",
                "description": "Search published tools with filters, sorting, and pagination."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/tools/{slug}",
                "description": "Full detail for one published tool."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/tools/{slug}/alternatives",
                "description": "Curated and external alternatives for a published tool."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/compare",
                "description": "Compare two to five published tools by repository metrics."
            },
            {
                "method": "GET",
                "path": "/api/public/v1/categories",
                "description": "Active categories with published tool counts."
            }
        ],
        "formats": [
            {
                "type": "llms.txt",
                "url": "https://fosshunter.com/llms.txt",
                "description": "Concise discovery document for AI agents."
            },
            {
                "type": "llms-full.txt",
                "url": "https://fosshunter.com/llms-full.txt",
                "description": "Full rulebook: interpretation rules, field dictionary, endpoint reference."
            },
            {
                "type": "openapi",
                "url": "https://fosshunter.com/openapi-public.json",
                "description": "OpenAPI 3.1 specification for the public API."
            },
            {
                "type": "markdown",
                "url": "https://fosshunter.com/tools.md",
                "description": "Whole-catalog markdown index."
            },
            {
                "type": "markdown",
                "url": "https://fosshunter.com/tools/{slug}.md",
                "description": "Markdown export for one tool."
            },
            {
                "type": "json",
                "url": "https://fosshunter.com/tools/{slug}.json",
                "description": "Canonical JSON export for one tool."
            },
            {
                "type": "mcp",
                "url": "https://fosshunter.com/.well-known/mcp.json",
                "description": "MCP server discovery document."
            }
        ],
        "rate_limits": {
            "api": {
                "requests_per_minute": 60,
                "scope": "per IP address"
            },
            "mcp": {
                "requests_per_minute": 30,
                "scope": "per IP address"
            }
        },
        "documentation_url": "https://fosshunter.com/agents"
    },
    "meta": {
        "canonical_url": "https://fosshunter.com/api/public/v1/ai/discovery",
        "generated_at": "2026-08-22T02:49:10+00:00",
        "catalog_revision": 3288832417,
        "terms_url": "https://fosshunter.com/about#agent-access"
    }
}