# List plugins

`GET https://api.vidmoat.com/v1/plugins`

- Scope: `account.read`
- Cost: Free

List installed and owned plugins and their available tools.

## Response

Returns `200`.

### Response fields

- `data` (array): Plugins.
  - `slug` (string): Plugin slug.
  - `name` (string): Display name.
  - `description` (string): What it does.
  - `installed_at` (string or null): `null` for a plugin you own but never installed.
  - `owned` (boolean): You built it.
  - `visibility` (string): `private`, `unlisted` or `public`.
  - `available` (boolean): Whether you can call it now.
  - `unavailable_reason` (string or null): Why not, when `available` is `false`.
  - `tools` (array): `{ name, mcp_name, path, description, produces_media }` per tool.

## Request examples

```bash curl
curl https://api.vidmoat.com/v1/plugins \
  -H "Authorization: Bearer $VIDMOAT_KEY"
```

```js Node
const res = await fetch('https://api.vidmoat.com/v1/plugins', {
  headers: {
    Authorization: `Bearer ${process.env.VIDMOAT_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error?.message ?? `HTTP ${res.status}`);
console.log(data);
```

```python Python
import os
import requests

res = requests.get(
    "https://api.vidmoat.com/v1/plugins",
    headers={"Authorization": f"Bearer {os.environ['VIDMOAT_KEY']}"},
    timeout=60,
)
res.raise_for_status()
print(res.json())
```

## Example response

```json
{
  "object": "list",
  "data": [{
    "slug": "brand-kit",
    "name": "Brand kit",
    "description": "Pulls logos, colours and fonts from your brand portal.",
    "category": "design",
    "icon_url": null,
    "installed_at": "2026-09-01T10:00:00.000Z",
    "owned": false,
    "visibility": "public",
    "available": true,
    "unavailable_reason": null,
    "tools": [{ "name": "get_logo", "mcp_name": "brand_kit__get_logo", "path": "/v1/plugins/brand-kit/get_logo", "description": "Fetch the current logo.", "produces_media": "image" }]
  }]
}
```

---

Source: https://developer.vidmoat.com/developer/docs/api/plugins/list-plugins
Previous: [Run the editing agent](https://developer.vidmoat.com/developer/docs/api/generation/run-agent.md)
Next: [Call a plugin tool](https://developer.vidmoat.com/developer/docs/api/plugins/invoke-plugin-tool.md)
All documentation: https://developer.vidmoat.com/llms-full.txt