# Tools

Discover and invoke Seatool plugins through the gateway.

## Catalog first

Use `GET /api/seatool/v1/catalog` for available tools and `GET /api/seatool/v1/skill-catalog/catalog.json` for dynamic skill package metadata.


## Invoke a tool

Tool invocation uses `POST /api/seatool/v1/invoke/{plugin}/{tool}` and requires a tool invoke scope such as `tool:invoke` or `seatool:invoke`.

```bash
curl https://seachat.ai/api/seatool/v1/invoke/image.caption/caption_image \
  -H "Authorization: Bearer $SEACHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://example.com/image.png"}'
```