Skip to main content
POST
Issue MCP registry gateway token

Authorizations

Authorization
string
header
required

Enter a Forge service-account token or delegated OAuth access token. Mintlify adds the Bearer prefix.

Path Parameters

organizationId
string
required
itemRef
string
required

Readable MCP registry slug or item identifier.

Body

application/json
name
string
required

Human-readable client label shown in token lists.

Required string length: 1 - 80
scopes
enum<string>[]
Required array length: 1 element
Available options:
mcp:connect
expiresInDays
integer
default:90
Required range: 1 <= x <= 365

Response

One-time gateway token secret plus non-secret metadata.

token
object
required
gatewayToken
string
required

One-time plaintext secret. Forge retains only its hash.

Pattern: ^forge_mcp_[A-Za-z0-9_-]+$
message
string
required