{
  "schema_version": "a2a-agent-card/0.2",
  "name": "TKAWEN",
  "description": "TKAWEN is an Algerian multi-service technology company: digital platforms, software products, a professional network, certificate verification (with AlgeriaCertify), and professional training as one of its services. This card lists the public, read-only skills an AI agent can call on tkawen.com.",
  "url": "https://tkawen.com",
  "provider": {
    "organization": "TKAWEN",
    "url": "https://tkawen.com"
  },
  "version": "1.0.0",
  "documentationUrl": "https://tkawen.com/developers",
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json", "text/html"],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "authentication": "none"
  },
  "languages": ["ar", "fr", "en"],
  "skills": [
    {
      "id": "verify_certificate",
      "name": "Verify a certificate",
      "description": "Check whether a certificate code (e.g. AC-2026-XXXXXX) issued through AlgeriaCertify is valid, revoked or unknown. Returns only what the public verify page shows. Revoked certificates always return valid:false.",
      "tags": ["certificate", "verification", "trust", "algeria"],
      "endpoint": {
        "method": "GET",
        "url": "https://tkawen.com/api/v1/verify/{code}",
        "alt_url": "https://tkawen.com/api/v1/verify?code={code}",
        "rate_limit": "60 requests per minute per IP",
        "documentation": "https://tkawen.com/developers/verify"
      },
      "input": {
        "code": "string, 4-64 chars of A-Z, 0-9 and '-' (case-insensitive)"
      },
      "output": {
        "valid": "boolean",
        "status": "valid | revoked | not_found | invalid | unavailable",
        "code": "string",
        "holder_display": "string (valid only)",
        "title": "string — the course or qualification (valid only)",
        "issuer": "{ name: string|null, org_url: string|null } (valid only)",
        "issued_at": "YYYY-MM-DD (valid only)",
        "expires_at": "YYYY-MM-DD | null (valid only)",
        "verify_url": "human verification page on tkawen.com",
        "checked_at": "ISO 8601"
      },
      "examples": ["https://tkawen.com/api/v1/verify/AC-2026-RTLZEX"]
    },
    {
      "id": "find_training_by_wilaya",
      "name": "Find training by wilaya",
      "description": "List the Algerian wilayas (69) with their training pages, then open the page of one wilaya for the training offers and verified organisations there.",
      "tags": ["training", "wilaya", "algeria", "geo"],
      "endpoint": {
        "method": "GET",
        "url": "https://tkawen.com/data/wilayas.json",
        "page_url": "https://tkawen.com/formation/{wilaya-slug}",
        "index_url": "https://tkawen.com/formation"
      },
      "input": {
        "wilaya": "wilaya slug as listed in wilayas.json (e.g. annaba, oran, alger)"
      },
      "output": {
        "wilayas.json": "application/json list of wilayas",
        "page": "text/html page per wilaya"
      }
    },
    {
      "id": "find_trainer",
      "name": "Find a certified trainer",
      "description": "Browse the public directory of certified trainers (approved and public profiles only, no contact details), or open one trainer by code.",
      "tags": ["trainer", "directory", "certified"],
      "endpoint": {
        "method": "GET",
        "url": "https://tkawen.com/trainers",
        "item_url": "https://tkawen.com/trainers/{code}",
        "item_json": "https://tkawen.com/pro/trainers/{code}.json"
      },
      "input": {
        "code": "trainer code, e.g. TRN-XXXXXX (optional)"
      },
      "output": {
        "page": "text/html directory or profile",
        "item_json": "application/json public trainer record"
      }
    },
    {
      "id": "request_academy",
      "name": "Request an academy (TKAWEN OS)",
      "description": "Send an organisation to the TKAWEN OS order page to request its own branded academy platform. The agent links the user to the page; the order itself is completed by a human.",
      "tags": ["academy", "lms", "order", "tkawen-os"],
      "endpoint": {
        "method": "GET",
        "url": "https://tkawen.com/os/order",
        "product_url": "https://tkawen.com/os"
      },
      "input": {},
      "output": {
        "page": "text/html order form (human completes it)"
      }
    }
  ],
  "mcp": {
    "name": "TKAWEN Intelligence Gateway",
    "url": "https://mcp.tkawen.com",
    "transport": "streamable-http (JSON-RPC 2.0 over POST)",
    "documentation": "https://mcp.tkawen.com/llms.txt"
  },
  "trust": {
    "badges": "https://tkawen.com/badge/org/{slug}.svg and https://tkawen.com/badge/trainer/{code}.svg — verified entities only, 404 otherwise",
    "terms": "https://tkawen.com/terms"
  }
}