> ## Documentation Index
> Fetch the complete documentation index at: https://www.aptible.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Grants

> Scope which tools each user or agent can call using grants.

## Overview

A grant is the record that authorizes a set of members to call a specific set of tools. If no grant exists for a caller on a given tool, the call is rejected. There is no implicit access.

<Info>
  Account Owner or Admin permission is required to create and manage grants.
</Info>

A grant has two parts:

* **Users & Robots:** the people and automated accounts attached to the grant
* **Tools Allowed:** the specific tools members can call, selected per server

<Frame>
  <img src="https://mintcdn.com/aptible/hQ2bFHGVxNRuw0z6/images/MCP-Grants-1.png?fit=max&auto=format&n=hQ2bFHGVxNRuw0z6&q=85&s=60ad88a79ff73d013b5641c3986caa05" alt="MCP Grants" width="1280" height="720" data-path="images/MCP-Grants-1.png" />
</Frame>

## Create a Grant

<AccordionGroup>
  <Accordion title="Create a new grant (Admins only)">
    <Steps>
      <Step title="Open the Grants page">
        In the Aptible dashboard, navigate to **MCP > Grants** and click **New Grant**.
      </Step>

      <Step title="Name the grant">
        Enter a **Grant Name** that describes the scope (e.g. `GitHub (Eng)`, `Toolshed (Owners)`).
      </Step>

      <Step title="Add users and robots">
        Under **Users & Robots**, search for and select the members who should receive this grant. Both user accounts and robot accounts appear in this list.
      </Step>

      <Step title="Choose tools and save">
        Under **Tools Allowed**, expand the servers you want to include. Select individual tools, or check **Select all tools (wildcard \*)** to allow all current and future tools on that server. Click **Save** to apply the grant.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

Tools are grouped by server and by category (e.g. read-only vs. write). The count badge next to each server shows how many tools are selected out of how many are available.

## Related

<CardGroup cols={2}>
  <Card title="Membership" href="/mcp-gateway/membership">
    Create robots and API keys to add to your grants.
  </Card>

  <Card title="Audit Logging" href="/mcp-gateway/audit-logs">
    See every tool call made by grant members.
  </Card>
</CardGroup>