Skip to main content
MCP GATEWAY / MANAGEMENT API V1

MCP Management API playground

List, add, install and remove MCPs, change their settings and upstream credentials, review new tools and upstream tool changes, connect OAuth MCPs, change REST API MCPs, write and test-run custom tools, hand MCPs out with client setup, sign-in links, MCP API tokens and allowed agents, rotate OAuth clients, see and revoke users' connections, change organization switches, read usage, latency, DLP activity and the audit trail, and see the exact API call behind every action.

Requests go straight from your browser to the MCP Gateway. The key stays in memory (or in this tab's session storage if you opt in) and is never shown in activity or snippets. Credentials, extra header values, URL query strings and connect links are masked in activity.

What you can do here

Everything below uses the public MCP Gateway Management API. Paste a management key issued in the console (Settings > AI Gateway > MCP Gateway > Management API), and every action shows the request it sends.

Scopes

Management keys carry explicit scopes. All scopes an operation lists are required; no scope implies another.

ScopeConsole labelAllows
agents:write Manage agentsCreate and delete custom agents.
connections:write Revoke connectionsRevoke a user's stored credentials for an MCP.
credentials:write Set credentialsSet or remove upstream credentials and extra headers or query parameters (also needed for any create, check or preview that carries credentials).
mcps:write Manage MCPsCreate, rename, enable, disable and remove MCPs, install catalog MCPs, check MCP URLs, preview REST API specs, refresh tools and issue OAuth connect links.
read ReadRead MCPs, tools, settings, credential metadata, tool reviews, connection state, the catalog, operations, analytics and this document.
settings:write Change settingsChange MCP settings and per-user or per-smart-group overrides (also needed to send settings with a create).
tenant_settings:write Tenant settingsChange tenant switches, manage tool-argument aliases and dismiss users' MCP requests.
tokens:write Issue MCP tokensIssue and revoke MCP API tokens.
tool_reviews:write Review toolsApprove or reject tools held for review, and check, adopt or dismiss upstream tool changes.
tools:write Custom toolsCreate, change, delete and test-run custom tools. Test runs call the MCP as the key owner.

Operations by area

Open the API Explorer for the full list.

AreaOperationsYour key can call
Reference3-
MCPs9-
Catalog3-
Settings5-
Upstream credentials3-
Connections3-
Tool reviews3-
Tool changes6-
REST API MCPs7-
Custom tools10-
Client access10-
User sign-in3-
User connections4-
Tenant10-
Analytics6-
Audit1-
Administration7Tenant administrator token (console)