agentry-com Agents API

The agents API from agentry-com — 5 operation(s) for agents.

Operations 5

GET /api/agents List Agents #
GET /api/agents/search Search Agents #
GET /api/agents/categories List Categories #
GET /api/agents/{agent_id} Get Agent #
POST /api/agents/register Register Agent #

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/agentry-com:agentry-com-agents-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.

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

OpenAPI Specification

agentry-com-agents-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agentry Agents API
  description: AI Agent Registry and Discovery service — browse, search, and register AI agents. Machine-readable via /llms.txt, /.well-known/agents.json, and /api/agents/public (A2A).
  version: 0.4.0
tags:
- name: Agents
paths:
  /api/agents:
    get:
      tags:
      - Agents
      summary: List Agents
      description: 'List AI agents in the Agentry directory with optional filtering and pagination.


        Returns a paginated list of AI agents including their name, description, category,

        pricing, trust score, key features, integrations, and A2A/MCP support status.

        The directory contains 122+ agents across 11 categories.'
      operationId: list_agents_api_agents_get
      parameters:
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter agents by category name (e.g. 'Sales & Outreach', 'Customer Support', 'Development Tools'). Returns all categories if omitted.
          title: Category
        description: Filter agents by category name (e.g. 'Sales & Outreach', 'Customer Support', 'Development Tools'). Returns all categories if omitted.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          description: 'Maximum number of agents to return per page. Range: 1-100.'
          default: 20
          title: Limit
        description: 'Maximum number of agents to return per page. Range: 1-100.'
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Number of agents to skip for pagination. Use with limit for paging.
          default: 0
          title: Offset
        description: Number of agents to skip for pagination. Use with limit for paging.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Agents Api Agents Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/search:
    get:
      tags:
      - Agents
      summary: Search Agents
      description: 'Search the Agentry AI agent directory by keyword.


        Performs a full-text search across agent names, descriptions, key features,

        and integration lists. Returns matching agents ranked by relevance with

        trust scores, pricing, and capability metadata.'
      operationId: search_agents_api_agents_search_get
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
          description: 'Search keyword to match against agent name, description, features, and integrations. Examples: ''customer support'', ''slack'', ''code review'', ''sales automation''.'
          default: ''
          title: Q
        description: 'Search keyword to match against agent name, description, features, and integrations. Examples: ''customer support'', ''slack'', ''code review'', ''sales automation''.'
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Optionally narrow search results to a specific category (e.g. 'Sales & Outreach', 'Customer Support').
          title: Category
        description: Optionally narrow search results to a specific category (e.g. 'Sales & Outreach', 'Customer Support').
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          description: 'Maximum number of search results to return. Range: 1-100.'
          default: 20
          title: Limit
        description: 'Maximum number of search results to return. Range: 1-100.'
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Number of results to skip for pagination.
          default: 0
          title: Offset
        description: Number of results to skip for pagination.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Search Agents Api Agents Search Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/categories:
    get:
      tags:
      - Agents
      summary: List Categories
      description: 'List all agent categories with counts.


        Returns every category in the directory along with the number of agents

        in each. Useful for building category filters or understanding the

        directory''s coverage areas.'
      operationId: list_categories_api_agents_categories_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/CategoryCount'
                type: array
                title: Response List Categories Api Agents Categories Get
  /api/agents/{agent_id}:
    get:
      tags:
      - Agents
      summary: Get Agent
      description: 'Get full details for a specific AI agent by ID.


        Returns comprehensive agent information including name, description, URL,

        category, pricing model, trust score, trust tier, verification status,

        key features, integrations, A2A support, MCP support, and A2A agent card

        if available.'
      operationId: get_agent_api_agents__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          description: The unique agent identifier, e.g. 'agent-0001'. Found in search/list results.
          title: Agent Id
        description: The unique agent identifier, e.g. 'agent-0001'. Found in search/list results.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Agent Api Agents  Agent Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/agents/register:
    post:
      tags:
      - Agents
      summary: Register Agent
      description: 'Register a new AI agent in the Agentry directory.


        Submit an AI agent for listing. The agent will be added immediately and

        appear in search results. Optional fields like pricing, features, and

        integrations improve discoverability. An A2A discovery scan will be

        triggered automatically if the agent URL is reachable.'
      operationId: register_agent_api_agents_register_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentRegistration'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Register Agent Api Agents Register Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CategoryCount:
      properties:
        category:
          type: string
          title: Category
        count:
          type: integer
          title: Count
      type: object
      required:
      - category
      - count
      title: CategoryCount
      description: Category with its agent count.
    AgentRegistration:
      properties:
        name:
          type: string
          title: Name
          description: Name of the AI agent to register
        url:
          type: string
          title: Url
          description: Public URL where the agent is accessible
        category:
          type: string
          title: Category
          description: Category for the agent (e.g. Sales & Outreach, Customer Support, Development Tools)
          default: Uncategorized
        description:
          type: string
          title: Description
          description: A brief description of what the agent does and its capabilities
          default: ''
        pricing_model:
          type: string
          title: Pricing Model
          description: 'Pricing model: Free, Freemium, Subscription, Pay-per-use, Contact for pricing'
          default: Unknown
        starting_price:
          type: string
          title: Starting Price
          description: Starting price or pricing tier (e.g. Free, $10/mo, Contact)
          default: Unknown
        key_features:
          type: string
          title: Key Features
          description: Comma-separated list of key features and capabilities
          default: ''
        integrations:
          type: string
          title: Integrations
          description: Comma-separated list of integrations (e.g. Slack, Salesforce, GitHub)
          default: ''
        a2a_support:
          type: string
          title: A2A Support
          description: Whether the agent supports the A2A protocol (Yes/No/Unknown)
          default: Unknown
        mcp_support:
          type: string
          title: Mcp Support
          description: Whether the agent exposes MCP tools (Yes/No/Unknown)
          default: Unknown
        contact_email:
          anyOf:
          - type: string
          - type: 'null'
          title: Contact Email
          description: Contact email for the agent developer/company
      type: object
      required:
      - name
      - url
      title: AgentRegistration
      description: Payload for registering a new agent in the directory.