openapi: 3.0.3
info:
  title: AgentPress Static Discovery API
  version: 0.3.0
  description: Static HTTPS resources for agent-native publications. No authentication; use these paths to discover, ingest, validate, communicate, and cite AgentPress bundles.
servers:
  - url: https://barneywohl.github.io/agentpress
paths:
  /:
    get:
      summary: Human and agent landing page
      responses:
        '200': {description: OK}
  /llms.txt:
    get:
      summary: Compact LLM and crawler instructions
      responses:
        '200': {description: OK}
  /.well-known/ai-ingestion.json:
    get:
      summary: Root AI ingestion manifest
      responses:
        '200': {description: OK}
  /.well-known/agentpress.json:
    get:
      summary: AgentPress product discovery manifest
      responses:
        '200': {description: OK}
  /agentpress/:
    get:
      summary: AgentPress registry landing page
      responses:
        '200': {description: OK}
  /agentpress/agentpress-registry.json:
    get:
      summary: Canonical bundle registry
      responses:
        '200': {description: OK}
  /agentpress/articles/article-index.json:
    get:
      summary: Machine-readable article index
      responses:
        '200': {description: OK}
  /agentpress/protocols/mcp-manifest.json:
    get:
      summary: MCP-style static resource and tool contract manifest
      responses:
        '200': {description: OK}
  /agentpress/protocols/executable-contracts.json:
    get:
      summary: CLI and eval fixtures for deterministic agent testing
      responses:
        '200': {description: OK}
  /agentpress/feeds/agentpress-feed.json:
    get:
      summary: JSON Feed for agent updates
      responses:
        '200': {description: OK}
  /agentpress/feeds/rss.xml:
    get:
      summary: RSS feed for crawlers and agents
      responses:
        '200': {description: OK}
