{
  "name": "hlido",
  "display_name": "Hlido \u2014 AI Agent Trust Layer",
  "publisher": "hlido.eu",
  "homepage": "https://hlido.eu",
  "contact": "ankit@hlido.eu",
  "description": "Independent, C2PA-verified reviews of AI agents. Query Laddoo Scores, tier verdicts, and evidence bundles over MCP.",
  "mcp": {
    "endpoint": "https://hlido.eu/mcp",
    "transport": "http",
    "protocol_version": "2024-11-05",
    "server_card": "https://hlido.eu/.well-known/mcp-server-card/server.json",
    "auth": "none"
  },
  "rest_api": {
    "endpoint": "https://hlido.eu/v1",
    "docs": "https://hlido.eu/api/",
    "openapi": "https://hlido.eu/v1/openapi.json",
    "auth": "bearer (hlk_live_*)",
    "free_tier": "100 calls/day, top-1 results, no key required",
    "tiers": [
      {
        "name": "free",
        "price_eur": 0,
        "calls": "100/day",
        "k": 1
      },
      {
        "name": "dev",
        "price_eur": 9,
        "billing": "monthly",
        "calls": "10000/month",
        "k": "1-10"
      },
      {
        "name": "team",
        "price_eur": 19,
        "billing": "monthly",
        "calls": "100000/month",
        "k": "1-25"
      }
    ],
    "endpoints": [
      {
        "method": "POST",
        "path": "/v1/recommend",
        "purpose": "Constraint-driven shortlist"
      },
      {
        "method": "GET",
        "path": "/v1/agents/{slug}",
        "purpose": "Public scorecard summary (whitelist)"
      },
      {
        "method": "GET",
        "path": "/v1/categories",
        "purpose": "13 canonical categories + counts"
      },
      {
        "method": "GET",
        "path": "/v1/health",
        "purpose": "Uptime + last_registry_update"
      },
      {
        "method": "GET",
        "path": "/v1/usage",
        "purpose": "Caller's tier + remaining quota"
      },
      {
        "method": "GET",
        "path": "/v1/stats/public",
        "purpose": "Daily aggregate counts"
      }
    ]
  },
  "tools": [
    {
      "name": "trust_check",
      "description": "One-call trust summary for any reviewed agent (slug or URL)."
    },
    {
      "name": "find_trusted",
      "description": "Ranked matches for a free-text need."
    },
    {
      "name": "verify_claim",
      "description": "Check whether a specific claim has been tested by Hlido."
    },
    {
      "name": "compare_agents",
      "description": "Side-by-side comparison of up to 5 agents."
    },
    {
      "name": "submit_agent",
      "description": "Queue a new agent for independent review."
    },
    {
      "name": "get_scorecard",
      "description": "Fetch the full sanitized claim-vs-evidence scorecard for one slug (schema v1.0)."
    },
    {
      "name": "report_review_issue",
      "description": "Report stale/wrong/missing claim or broken link on a Hlido review."
    },
    {
      "name": "request_quick_audit",
      "description": "Commission an audit for a NEW agent that has no Hlido review yet."
    },
    {
      "name": "find_similar_agents",
      "description": "Semantic (embedding) search across the review corpus."
    },
    {
      "name": "subscribe",
      "description": "Preview - register interest in verdict changes for a slug. Wave 3 will add persistent webhook + RSS subscriptions; today this returns current state plus advisory polling instructions."
    },
    {
      "name": "explain",
      "description": "Structured natural-language explanation of why an agent has its current score, claim by claim. Optional dimension filter (homepage/docs/pricing/etc)."
    },
    {
      "name": "recommend",
      "description": "Constraint-driven shortlist: filter by category/tier/min_score and optionally rank by use_case."
    }
  ],
  "attestation_url_pattern": "https://hlido.eu/data/attestations/{slug}.json",
  "attestation_index_url": "https://hlido.eu/data/attestations/index.json",
  "trust_endpoints": {
    "registry": {
      "url": "https://hlido.eu/data/review-registry.json",
      "description": "Canonical index of every reviewed agent \u2014 slug, name, category, score, tier, summary, last review timestamps."
    },
    "scorecards": {
      "url_pattern": "https://hlido.eu/data/scorecards/{slug}.json",
      "description": "Per-agent claim-vs-evidence table with verdicts, source surfaces, and confidence."
    },
    "attestations": {
      "url_pattern": "https://hlido.eu/data/attestations/{slug}.json",
      "index_url": "https://hlido.eu/data/attestations/index.json",
      "description": "HMAC-SHA256 signed envelope of public review metadata (slug, score, tier, evidence_count, last_tested) \u2014 verify integrity without scraping HTML."
    }
  },
  "data_license": "Sanitized metadata (name, category, tier, score, date, URL) is mirrored to https://huggingface.co/datasets/hlido-eu/agent-benchmark under CC-BY-4.0. Full evidence and attestations remain on hlido.eu.",
  "disclosure": "Hlido is the independent review desk; reviews are editorial. Verified Badge subscriptions are a separate product and do not influence scoring.",
  "editorial": {
    "voice": "Hlido Editor",
    "scorecard_schema_version": "2.0",
    "narrative_per_review": true,
    "comparative_anchor_per_review": true,
    "agent_relevance_per_review": true,
    "red_flags_surfaced": true,
    "freshness_field": "staleness_after (default 90 days)",
    "methodology_url": "/methodology/public-surface-tier-1/",
    "methodology_version": "2026.05",
    "differentiation_vs_aggregators": "Named editorial voice with documented methodology, not vote/scrape aggregation. Every review carries hlido_opinion {headline, body, voice, as_of}, tier_rationale, what_it_does_well, what_it_fails_at, best_for, not_recommended_for, red_flags, compared_to [{slug, verdict_diff, preferred_for_axis}], agent_relevance {has_api/cli/mcp/webhook/sdk + agent_friendly_score 0-10}.",
    "for_agents_url": "/for-agents/",
    "fluff_words_banned": [
      "revolutionary",
      "game-changing",
      "best-in-class",
      "world-class"
    ]
  }
}