---
title: "List grants"
method: GET
path: "/client/mcp/grants"
tags: ["Tool gateway"]
---

# List grants

`GET /client/mcp/grants`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/mcp/grants`
- Auth: HTTP bearer

Which bundle is given to which project or key. An agent’s tools are its key’s bundles plus its project’s. Requires `mcp:read`.

## Response `200`

Grants

- McpGrantList
  - `data` McpGrant[], required
    - `id` string, uuid, required
    - `clientId` string, uuid, required
    - `groupId` string, uuid, required
    - `apiKeyId` string, uuid, nullable, required: Set for a grant to one key
    - `projectId` string, uuid, nullable, required: Set for a grant to every key in a project
    - `access` 'read_only' | 'ask' | 'full', required: `read_only`: tools that change things are hidden. `ask`: each call to one waits for an owner or admin to approve it in the console. `full`: every tool runs. Where several grants serve one tool, the most permissive wins
    - `callLimit` integer, nullable, required: At most this many calls through the grant per `callLimitPer`; null for no limit
    - `callLimitPer` 'minute' | 'day', nullable, required: A day is a UTC day
    - `callsToday` integer, nullable, required: Calls through the grant today (UTC), for a per-day limit only
    - `createdAt` string, date-time, required

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)