---
title: "Public agent directory"
method: GET
path: "/v1/agents/directory"
tags: ["Discovery"]
---

# Public agent directory

`GET /v1/agents/directory`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/agents/directory`
- Auth: none required

Browse the public directory of discoverable agents.

## Query parameters

- `page` integer
- `per_page` integer
- `tags` string
- `q` string

## Response `200`

Directory listing

- DirectoryResponse
  - `agents` DirectoryEntry[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, nullable
    - `tags` string[]
    - `capabilities` string[]
    - `a2a_url` string, nullable
    - `mcp_url` string, nullable
    - `org_name` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)