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: 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.