Index

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/indexagentica-com/json-schema/indexagentica-com-index-schema.json",
  "title": "Index",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/indexagentica-com-openapi.json#/components/schemas/Index",
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "version": {
      "type": "string"
    },
    "generated": {
      "type": "string",
      "format": "date-time"
    },
    "site_url": {
      "type": "string",
      "format": "uri"
    },
    "schema": {
      "type": "string",
      "format": "uri"
    },
    "openapi": {
      "type": "string",
      "format": "uri"
    },
    "llms_txt": {
      "type": "string",
      "format": "uri"
    },
    "repository": {
      "type": "string",
      "format": "uri"
    },
    "contribute_url": {
      "type": "string",
      "format": "uri"
    },
    "longform": {
      "type": "string",
      "format": "uri"
    },
    "license": {
      "type": "object"
    },
    "contribute": {
      "type": "object",
      "description": "Same as /contribute.json"
    },
    "counts": {
      "type": "object",
      "properties": {
        "total": {
          "type": "integer"
        },
        "by_category": {
          "type": "object",
          "additionalProperties": {
            "type": "integer"
          }
        },
        "longform": {
          "type": "object"
        }
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/CategorySummary"
      }
    },
    "entries": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Entry"
      }
    }
  },
  "$defs": {
    "CategorySummary": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "count": {
          "type": "integer"
        },
        "html": {
          "type": "string",
          "format": "uri"
        },
        "json": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "Entry": {
      "title": "Index Agentica directory entry",
      "description": "One entry in the Index Agentica directory. Stored at content/<category>/<id>.json, one entry per file.",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "name",
        "category",
        "summary",
        "url",
        "added"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Kebab-case slug. Must equal the filename without .json and be unique across all categories.",
          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
          "minLength": 2,
          "maxLength": 80
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Human/agent-readable display name."
        },
        "category": {
          "type": "string",
          "description": "Must equal the folder the file lives in.",
          "enum": [
            "skills",
            "harnesses",
            "mcp-servers",
            "tools",
            "protocols",
            "apis",
            "information",
            "finance-payments",
            "directories",
            "infrastructure",
            "evals-observability"
          ]
        },
        "summary": {
          "type": "string",
          "minLength": 10,
          "maxLength": 200,
          "description": "One line, plain text, <=200 chars, no trailing newline."
        },
        "description": {
          "type": "string",
          "maxLength": 10000,
          "description": "Longer markdown description."
        },
        "url": {
          "type": "string",
          "format": "uri",
          "pattern": "^https?://",
          "description": "Canonical homepage."
        },
        "repo": {
          "type": "string",
          "format": "uri",
          "pattern": "^https?://",
          "description": "Source repository."
        },
        "docs": {
          "type": "string",
          "format": "uri",
          "pattern": "^https?://",
          "description": "Documentation URL."
        },
        "tags": {
          "type": "array",
          "uniqueItems": true,
          "maxItems": 20,
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
            "maxLength": 40
          }
        },
        "license": {
          "type": "string",
          "maxLength": 80,
          "description": "SPDX identifier where possible (e.g. MIT, Apache-2.0), or 'proprietary'."
        },
        "pricing": {
          "type": "string",
          "enum": [
            "free",
            "freemium",
            "paid",
            "open-source",
            "unknown"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "active",
            "beta",
            "deprecated",
            "unknown"
          ]
        },
        "agent_access": {
          "type": "object",
          "description": "How an agent can consume this resource programmatically.",
          "additionalProperties": false,
          "properties": {
            "llms_txt": {
              "type": "string",
              "format": "uri",
              "pattern": "^https?://"
            },
            "openapi": {
              "type": "string",
              "format": "uri",
              "pattern": "^https?://"
            },
            "mcp_endpoint": {
              "type": "string",
              "format": "uri",
              "pattern": "^(https?|wss?)://"
            },
            "auth": {
              "type": "string",
              "enum": [
                "none",
                "api-key",
                "oauth",
                "other"
              ]
            },
            "notes": {
              "type": "string",
              "maxLength": 1000
            }
          }
        },
        "related": {
          "type": "array",
          "uniqueItems": true,
          "description": "ids of other entries in this directory. Every id must exist.",
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
          }
        },
        "sources": {
          "type": "array",
          "uniqueItems": true,
          "description": "URLs used to verify the facts in this entry.",
          "items": {
            "type": "string",
            "format": "uri",
            "pattern": "^https?://"
          }
        },
        "added": {
          "type": "string",
          "format": "date",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "updated": {
          "type": "string",
          "format": "date",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "last_verified": {
          "type": "string",
          "format": "date",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Date someone last checked the facts and links against the sources (YYYY-MM-DD). Not before added. Used for freshness (last_verified, else updated, else added)."
        },
        "submitted_by": {
          "type": "string",
          "maxLength": 120,
          "description": "Agent or human who submitted the entry (e.g. 'Curator (agent)', 'github:username')."
        },
        "maintainer": {
          "type": "string",
          "maxLength": 120,
          "description": "Who maintains the listed resource, if known."
        },
        "longform": {
          "type": "array",
          "description": "Published long-form items that reference this entry",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              },
              "json": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        },
        "links": {
          "type": "object",
          "properties": {
            "html": {
              "type": "string",
              "format": "uri"
            },
            "markdown": {
              "type": "string",
              "format": "uri"
            },
            "json": {
              "type": "string",
              "format": "uri"
            },
            "source": {
              "type": "string",
              "format": "uri"
            }
          }
        }
      }
    }
  }
}