Luther Systems

AgentSearch HTTP API

Public, no-auth HTTP API for AgentSearch, Luther Systems' daily-scored index of AI agents and MCP servers, at https://agentsearch.luthersystems.com. Six operations described by a provider-published OpenAPI 3.1.0 (POST /api/search, GET /api/agent/{name}, POST /api/found-agent, GET /api/browse, GET /api/stats, GET /.well-known/agent.json) that the spec itself says mirrors the @luthersystems/agentsearch MCP server; POST /api/submit-agent is documented on /api-docs but not in the spec. Read-only, best-effort ~60 requests/minute/IP, MIT-licensed surfaces on GitHub.

Documentation GitHub OpenAPI

Operations 6

POST /api/search Search the index #

GET /api/agent/{name} Get one agent profile #

POST /api/found-agent Live-score an arbitrary agent URL #

GET /api/browse Paginated index listing #

GET /api/stats Index summary stats #

GET /.well-known/agent.json A2A agent card #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/agentsearch-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: AgentSearch HTTP 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
externalDocs:
  description: AgentSearch API & agent surfaces
  url: https://agentsearch.luthersystems.com/api-docs
servers:
- url: https://agentsearch.luthersystems.com
  description: production
tags:
- name: Search
  description: Natural-language search over the agent index.
- name: Agents
  description: Scored profiles of indexed agents.
- name: Scoring
  description: Live scoring of an arbitrary agent URL.
- name: Index
  description: Browse and summarise the whole index.
- name: Discovery
  description: A2A agent card.
paths:
  /api/search:
    post:
      summary: Search the index
      description: Ranked agents for a natural-language query. final_score = query_fit × agent_quality.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                limit:
                  type: integer
                  minimum: 1
                  maximum: 25
                  default: 10
              required:
              - query
      responses:
        '200':
          description: Top N ranked agents.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchResult'
      operationId: searchAgents
      tags:
      - Search
  /api/agent/{name}:
    get:
      summary: Get one agent profile
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Full scored profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDetails'
        '404':
          description: Agent not in index.
      operationId: getAgent
      tags:
      - Agents
  /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'
      operationId: scoreFoundAgent
      tags:
      - Scoring
  /api/browse:
    get:
      summary: Paginated index listing
      parameters:
      - name: page
        in: query
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: page_size
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 200
          default: 100
      responses:
        '200':
          description: One page of agents.
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                  page_size:
                    type: integer
                  total:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/AgentSummary'
      operationId: browseAgents
      tags:
      - Index
  /api/stats:
    get:
      summary: Index summary stats
      responses:
        '200':
          description: Aggregates across the latest scoring tab.
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_agents:
                    type: integer
                  alive:
                    type: integer
                  tab:
                    type: string
                    description: Source tab name, e.g. 'agents 2026-05-16'.
                  top_sources:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rollup'
                  top_licenses:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rollup'
                  top_capability_clusters:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rollup'
      operationId: getStats
      tags:
      - Index
  /.well-known/agent.json:
    get:
      summary: A2A agent card
      description: Returns the A2A-format agent card declaring AgentSearch's skills, auth, pricing and documentation.
      responses:
        '200':
          description: Agent card.
      operationId: getAgentCard
      tags:
      - Discovery
components:
  schemas:
    SearchResult:
      type: object
      properties:
        agent_name:
          type: string
        agent_url:
          type: string
        query_fit:
          type: number
          minimum: 0
          maximum: 1
        overall_score:
          type: number
          minimum: 0
          maximum: 1
        final_score:
          type: number
          minimum: 0
          maximum: 1
        reasoning:
          type: string
    AgentSummary:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        overall_score:
          type: number
    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
    Rollup:
      type: object
      properties:
        name:
          type: string
        count:
          type: integer
x-api-evangelist:
  source: https://agentsearch.luthersystems.com/openapi.json
  fetched: '2026-09-19'
  http_status: 200
  original: openapi/_original/luthersystems-com-agentsearch-openapi.json
  changes: operationId, tags[] and externalDocs added by API Evangelist (the published spec declares none); every
    path, parameter, schema and server is as published. The same additions are expressed as an OpenAPI Overlay in
    overlays/luthersystems-com-agentsearch-overlay.yaml. The published spec omits POST /api/submit-agent, which
    /api-docs documents; it was NOT added here.