Agentry — AI Agent Directory

A2A Public Discovery A2A-compatible open discovery endpoint. Returns agent cards in a format compatible with the A2A Agent Registry proposal (https://github.com/a2aproject/A2A/discussions/741). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Search query to filter agents",
      "title": "q",
      "type": "string"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Filter by category",
      "title": "category",
      "type": "string"
    },
    "top": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "default": 50,
      "title": "top"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pagination cursor",
      "title": "cursor",
      "type": "string"
    }
  },
  "title": "a2a_public_discovery_api_agents_public_getArguments"
}

A2A Public Agent Card Return a single agent's A2A card by ID. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "a2a_public_agent_card_api_agents_public__agent_id__getArguments"
}

List Agents 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. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "category": {
      "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",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of agents to return per page. Range: 1-100.",
      "default": 20,
      "title": "limit"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of agents to skip for pagination. Use with limit for paging.",
      "default": 0,
      "title": "offset"
    }
  },
  "title": "list_agents_api_agents_getArguments"
}

Search Agents 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. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "q": {
      "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"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optionally narrow search results to a specific category (e.g. 'Sales & Outreach', 'Customer Support').",
      "title": "category",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of search results to return. Range: 1-100.",
      "default": 20,
      "title": "limit"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of results to skip for pagination.",
      "default": 0,
      "title": "offset"
    }
  },
  "title": "search_agents_api_agents_search_getArguments"
}

List Categories 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. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json **Example Response:** ```json [ { "category": "Category", "count": 1 } ] ```

{
  "type": "object",
  "properties": {},
  "title": "list_categories_api_agents_categories_getArguments"
}

Get Agent 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. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "The unique agent identifier, e.g. 'agent-0001'. Found in search/list results.",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_agent_api_agents__agent_id__getArguments"
}

Register Agent 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. ### Responses: **201**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "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": "string"
    }
  },
  "required": [
    "name",
    "url"
  ],
  "title": "register_agent_api_agents_register_postArguments"
}

Submit Intake Submit a broker intake request to find the right AI agent for your needs. Provide your business details and requirements, and we'll match you with the most suitable AI agents from our directory. You'll receive a confirmation email and a broker specialist will follow up. ### Responses: **201**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "business_name": {
      "type": "string",
      "title": "business_name",
      "default": ""
    },
    "email": {
      "type": "string",
      "title": "email",
      "default": ""
    },
    "business_type": {
      "type": "string",
      "title": "business_type",
      "default": ""
    },
    "needs": {
      "type": "string",
      "title": "needs",
      "default": ""
    },
    "budget": {
      "type": "string",
      "title": "budget",
      "default": ""
    },
    "tools": {
      "type": "string",
      "title": "tools",
      "default": ""
    },
    "urgency": {
      "type": "string",
      "title": "urgency",
      "default": "exploring"
    }
  },
  "title": "submit_intake_api_broker_intake_postArguments"
}

Get Intake Check the status of a previously submitted broker intake request. Returns the current status, any matched agents, and timestamps. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "intake_id": {
      "type": "string",
      "title": "intake_id"
    }
  },
  "required": [
    "intake_id"
  ],
  "title": "get_intake_api_broker_intake__intake_id__getArguments"
}

Trigger Scan Scan domains for A2A Agent Card discovery. Checks the given domains for /.well-known/agent.json endpoints and extracts agent capability metadata. Results are stored and can be retrieved via the scan results endpoint. ### Responses: **202**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "domains": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "domains"
    }
  },
  "required": [
    "domains"
  ],
  "title": "trigger_scan_api_scanner_scan_postArguments"
}

Get Scan Results Get recent A2A Agent Card scan results. Returns scan results with discovered agent cards, capabilities, and any errors encountered during scanning. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "default": 50,
      "title": "limit"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "title": "offset"
    }
  },
  "title": "get_scan_results_api_scanner_results_getArguments"
}

Get Mint Info Get info about a Cashu mint (NUT-06). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "mint_url": {
      "type": "string",
      "default": "https://mint.minibits.cash/Bitcoin",
      "title": "mint_url"
    }
  },
  "title": "get_mint_info_api_payments_ecash_mint_info_getArguments"
}

Get Mint Keys Get active public keys from a Cashu mint (NUT-01). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "mint_url": {
      "type": "string",
      "default": "https://mint.minibits.cash/Bitcoin",
      "title": "mint_url"
    }
  },
  "title": "get_mint_keys_api_payments_ecash_mint_keys_getArguments"
}

Get Mint Keysets Get all keysets from a Cashu mint (NUT-02). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "mint_url": {
      "type": "string",
      "default": "https://mint.minibits.cash/Bitcoin",
      "title": "mint_url"
    }
  },
  "title": "get_mint_keysets_api_payments_ecash_mint_keysets_getArguments"
}

Create Quote Create a Lightning invoice to fund ecash minting (NUT-04). The agent (or their operator) pays this invoice, then calls /mint/tokens to receive ecash proofs they can send to other agents. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "amount_sats": {
      "type": "integer",
      "title": "amount_sats"
    },
    "mint_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "mint_url",
      "type": "string"
    }
  },
  "required": [
    "agent_id",
    "amount_sats"
  ],
  "title": "create_quote_api_payments_ecash_mint_quote_postArguments"
}

Check Quote Check the payment status of a mint quote. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string",
      "title": "quote_id"
    },
    "mint_url": {
      "type": "string",
      "default": "https://mint.minibits.cash/Bitcoin",
      "title": "mint_url"
    }
  },
  "required": [
    "quote_id"
  ],
  "title": "check_quote_api_payments_ecash_mint_quote__quote_id__getArguments"
}

Create Melt Quote Get a quote to melt ecash into a Lightning payment (NUT-05). Used when an agent wants to pay a Lightning invoice using their ecash. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "payment_request": {
      "type": "string",
      "title": "payment_request"
    },
    "mint_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "mint_url",
      "type": "string"
    }
  },
  "required": [
    "agent_id",
    "payment_request"
  ],
  "title": "create_melt_quote_api_payments_ecash_melt_quote_postArguments"
}

Send Ecash Send ecash tokens from one agent to another. Two modes: 1. Provide a pre-minted `token` (cashuA...) — we verify and record the transfer 2. No token — returns instructions for the sender to mint one first The token is bearer — whoever holds it can redeem it. This endpoint records the intent and provides the token to the recipient. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "sender_agent_id": {
      "type": "string",
      "title": "sender_agent_id"
    },
    "recipient_agent_id": {
      "type": "string",
      "title": "recipient_agent_id"
    },
    "amount_sats": {
      "type": "integer",
      "title": "amount_sats"
    },
    "memo": {
      "type": "string",
      "title": "memo",
      "default": ""
    },
    "token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "token",
      "type": "string"
    }
  },
  "required": [
    "sender_agent_id",
    "recipient_agent_id",
    "amount_sats"
  ],
  "title": "send_ecash_api_payments_ecash_send_postArguments"
}

Receive Ecash Receive/redeem a Cashu ecash token. The agent swaps the received proofs for new ones at the mint, ensuring the sender can't double-spend. This is the standard Cashu receive flow (NUT-03 swap). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "token": {
      "type": "string",
      "title": "token"
    }
  },
  "required": [
    "agent_id",
    "token"
  ],
  "title": "receive_ecash_api_payments_ecash_receive_postArguments"
}

Verify Token Verify a Cashu ecash token — check format, amount, and spent status. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "title": "token"
    }
  },
  "required": [
    "token"
  ],
  "title": "verify_token_api_payments_ecash_verify_postArguments"
}

Get Payment Profile Get an agent's ecash payment profile. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_payment_profile_api_payments_ecash_profile__agent_id__getArguments"
}

Update Payment Profile Update an agent's ecash payment profile. Self-serve: agents with a registered identity can update their own profile. Admin key still works for platform operations. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "ecash_enabled": {
      "type": "boolean",
      "title": "ecash_enabled",
      "default": false
    },
    "cashu_mint_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "cashu_mint_url",
      "type": "string"
    },
    "lightning_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "lightning_address",
      "type": "string"
    },
    "accepted_mints": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "accepted_mints"
    },
    "payment_required": {
      "type": "boolean",
      "title": "payment_required",
      "default": false
    },
    "price_sats": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "price_sats",
      "type": "integer"
    },
    "total_received_sats": {
      "type": "integer",
      "title": "total_received_sats",
      "default": 0
    },
    "total_sent_sats": {
      "type": "integer",
      "title": "total_sent_sats",
      "default": 0
    },
    "last_payment_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "last_payment_at",
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "update_payment_profile_api_payments_ecash_profile__agent_id__putArguments"
}

List Transactions List ecash transactions, optionally filtered by agent or type. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "agent_id",
      "type": "string"
    },
    "tx_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "tx_type",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "title": "limit"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "title": "offset"
    }
  },
  "title": "list_transactions_api_payments_ecash_transactions_getArguments"
}

Agent Payment Summary Get payment summary for an agent — totals, balance, tx count. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "agent_payment_summary_api_payments_ecash_summary__agent_id__getArguments"
}

Payment Required Return a 402 Payment Required response with X-Cashu headers. This endpoint lets agents advertise that they charge for services. Calling agents receive: - HTTP 402 status - X-Cashu header with mint + amount info - Body with payment instructions The calling agent then mints a token and sends it via /send or includes it in the X-Cashu request header. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "payment_required_api_payments_ecash_402__agent_id__getArguments"
}

List Ecash Agents List all agents that have ecash payments enabled. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {},
  "title": "list_ecash_agents_api_payments_ecash_agents_getArguments"
}

Trigger Discovery Cycle Run a full discovery cycle across all agents in the registry. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {},
  "title": "trigger_discovery_cycle_api_registry_discover_postArguments"
}

Discover Single Agent Discover / re-check a single agent's A2A Agent Card. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "discover_single_agent_api_registry_discover__agent_id__postArguments"
}

Get Agent Trust Get the trust report for an agent. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_agent_trust_api_agents__agent_id__trust_getArguments"
}

Get Card History Get AgentCard snapshot history for an agent. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "default": 10,
      "title": "limit"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_card_history_api_agents__agent_id__card_history_getArguments"
}

Get Registry Stats Get registry-wide statistics. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {},
  "title": "get_registry_stats_api_registry_stats_getArguments"
}

Claim Agent Developer claims ownership of an existing agent listing. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "contact_email": {
      "type": "string",
      "title": "contact_email"
    },
    "name": {
      "type": "string",
      "title": "name",
      "default": ""
    },
    "message": {
      "type": "string",
      "title": "message",
      "default": ""
    }
  },
  "required": [
    "agent_id",
    "contact_email"
  ],
  "title": "claim_agent_api_agents_claim_postArguments"
}

Send Outreach Admin endpoint to send trust score outreach to a specific agent contact. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "contact_email": {
      "type": "string",
      "title": "contact_email"
    }
  },
  "required": [
    "agent_id",
    "contact_email"
  ],
  "title": "send_outreach_api_admin_outreach_postArguments"
}

Get Badge Svg Return an SVG badge for an agent listing. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    },
    "style": {
      "type": "string",
      "description": "Badge style (flat only for now)",
      "default": "flat",
      "title": "style"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_badge_svg_api_badges__agent_id__svg_getArguments"
}

Get Badge Json Return badge metadata in shields.io endpoint format. Can be used with: https://img.shields.io/endpoint?url=... ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_badge_json_api_badges__agent_id__json_getArguments"
}

Get Badge Embed Code Return embed code snippets for an agent's badge. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "agent_id"
    }
  },
  "required": [
    "agent_id"
  ],
  "title": "get_badge_embed_code_api_badges__agent_id__embed_getArguments"
}