---
title: "List the agents connected to the signed-in user's account over MCP"
method: GET
path: "/v1/me/connections"
tags: ["me"]
---

# List the agents connected to the signed-in user's account over MCP

`GET /v1/me/connections`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/me/connections`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer

## Query parameters

- `limit` integer: page size; 0 or absent means 50
- `cursor` string: next_cursor from the previous page; absent for the first page

## Response `200`

OK

- ConnectionPage
  - `data` ConnectionView[], required
    - `client_id` string, required: the agent's OAuth client id
    - `first_seen_at` string, date-time, required
    - `id` string, required
    - `last_seen_at` string, date-time, required
    - `resource_url` string, required: the MCP URL the agent connected to
    - `revoked_at` string, date-time, nullable, required: set while the connection is revoked
    - `scope` ConnectionScopeView, required
      - `ids` string[], required: org ids (kind orgs) or project ids (kind projects); empty for global
      - `kind` 'global' | 'orgs' | 'projects', required: global = the whole account; orgs or projects = only the listed ids
  - `next_cursor` string, nullable, required: pass as cursor to fetch the next page; null on the last page

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

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