---
title: "Agents and MCP overview"
description: "Grid82 MCP endpoints for suites, Studio, and public docs, OAuth app selection, and the Studio Developer screen."
canonical: "https://grid82.com/docs/developers/agents/overview"
updated: "2026-11-20"
---

# Agents and MCP overview

Grid82 implements the Model Context Protocol (MCP) over Streamable HTTP with OAuth 2.1 authentication. Every MCP connection acts strictly as the user who approved it and inherits their compiled permissions.

![Studio Developer screen showing Copy setup prompt (1) and New key (2)](/docs/images/app/studio-developer-connect.webp)

_The Studio Developer page showing Copy setup prompt (1) and New key (2) for builder keys and MCP setup_

1. **Copy setup prompt:** Hands Claude, ChatGPT, Cursor, or VS Code a self-configuring OAuth prompt (`https://studio.grid82.app/agent-setup.md` for Studio, or `https://{suite}.grid82.app/agent-setup.md` for a suite).
2. **New key:** Create scoped `g82_` API keys for scripts, CI pipelines, and MCP clients that authenticate by bearer token.

## MCP endpoints

| Server URL                            | What it reaches                                                        | Use it for                                                   |
| ------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------ |
| `https://{suite}.grid82.app/mcp`      | All apps of the suite you select during OAuth consent                  | End-user agents (Claude, ChatGPT, Cursor, VS Code)           |
| `https://{suite}.grid82.app/mcp/code` | Code Mode (`search` + `execute`) scoped to the selected app            | Agents running multi-step TypeScript scripts against an app  |
| `https://studio.grid82.app/mcp`       | Studio tools: apps, schemas, permission rules, users, pages, workflows | Builder agents creating or updating apps in one organisation |
| `https://studio.grid82.app/mcp/code`  | Code Mode (`search` + `execute`) over the Builder API                  | Builder agents scripting bulk schema or record operations    |
| `https://grid82.com/docs/mcp`         | Public documentation (`search`, `fetch`, `list_pages`)                 | Giving any coding or research agent live Grid82 docs         |

Custom suite domains serve the same `/mcp` and `/mcp/code` paths directly on your domain.

## One MCP server per suite

A suite exposes a single `/mcp` server for every app inside that workspace, so adding new apps never forces users to reconfigure their client:

- **`apps_list`** returns every app this OAuth grant can open, together with its `appId`.
- **`appId`** is accepted on every app tool (optional if the grant covers a single app, required when multiple apps are selected).
- **Masked tool schemas.** `tableId` enumerations and record properties reflect only the tables and fields the signed-in caller may read. Tables outside the user's roles are omitted completely.
- **Studio skills.** Calling `skills_list` and `skills_get` on the Studio MCP server gives an agent the up-to-date manuals for building schemas, permissions, Interface pages, and workflows.

Read [Set up your agent](/docs/developers/agents/setup) to connect your client in one prompt.
