Create gateway server
create_gateway_serverRegister an MCP server on the gateway with its first revision and activate it unless activate is false. Agents reach its tools as __, but only the tools set_agent_tool_access grants them, and every call still goes through the approval pipelines. Store an organization-held scope's credential afterwards with set_gateway_scope_headers; an OAuth scope is connected by a person in the app, and a member-held scope by each member on their Connections page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"server_slug": "<server_slug>",
"name": "<name>",
"scopes": "<scopes>"
},
"name": "create_gateway_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The downstream server's Streamable HTTP endpoint. Give exactly one of url and tunnel_id. | |
| name | Yes | Display name. | |
| scopes | Yes | The server's scopes (named credentials), 1 to 20, in the order agents see them. The whole list again on every revision: a scope left out is retired when the revision is activated and its stored credentials are dropped. | |
| activate | No | Activate the new revision right away so the gateway serves it from its next configuration poll. Defaults to true. | |
| tunnel_id | No | The id of the tunnel the downstream server is reached through (from list_gateway_tunnels), for a server inside your own network. Give exactly one of url and tunnel_id. | |
| server_slug | Yes | The server's slug: lowercase letters, digits and dashes. Agents see its tools as <slug>__<tool>. A new slug registers the server and is taken for good, archived servers included. |