openapi: 3.2.0
info:
  title: AgentSearch HTTP Found Agent API
  version: 0.1.0
  description: Public, no-auth HTTP API for AgentSearch — a daily-scored, curated index of AI agents and MCP servers. Mirrors the @luthersystems/agentsearch MCP server.
  contact:
    name: Luther Systems
    url: https://luthersystems.com
  license:
    name: MIT
    url: https://github.com/luthersystems/agentsearch/blob/main/LICENSE
servers:
- url: https://agentsearch.luthersystems.com
  description: production
tags:
- name: Found Agent
paths:
  /api/found-agent:
    post:
      summary: Live-score an arbitrary agent URL
      description: Crawls + probes + LLM-scores any URL using the same rubric the batch pipeline uses. Useful for agents not in the index yet.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                name:
                  type: string
                query:
                  type: string
              required:
              - url
      responses:
        '200':
          description: Live-scored agent profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDetails'
      tags:
      - Found Agent
      operationId: postApiFoundAgent
      x-operation-id-source: derived
components:
  schemas:
    AgentDetails:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        description:
          type: string
        capabilities:
          type: array
          items:
            type: string
        sources:
          type: array
          items:
            type: string
        raw:
          type: object
          additionalProperties: true
        blocker:
          type: object
          properties:
            status:
              type: string
              enum:
              - alive
              - dead
              - timeout
              - error
            status_code:
              type: integer
            speed_ms:
              type: number
            eliminated:
              type: boolean
        scores:
          type: object
          properties:
            fame:
              type: object
            usability:
              type: object
            functionality:
              type: object
            call_graph:
              type: number
            overall:
              type: number