---
title: "List connected agents"
method: GET
path: "/api/me/agents"
---

# List connected agents

`GET /api/me/agents`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/me/agents`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

The agents the member approved to act as them, over OAuth or the Personal Agent Protocol: name, domain, the poppy scopes granted, when each was connected, and when it last used Toma. Same as the list_connected_agents MCP tool.

## Response `200`

Connected agents, newest first.

- object
  - `agents` object[], required
    - `clientId` string, required
    - `name` string, required
    - `domain` string, required
    - `logoUrl` string, nullable, required
    - `scopes` string[], required
    - `grantedAt` string, date-time, required
    - `lastUsedAt` string, date-time, nullable, required

## Other responses

- `401`: Sign in first.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)