sn_mcp_create_server
Create a ServiceNow MCP server with optional tools. Draft adds a registry entry; active publishes the endpoint and waits for auto-created OAuth, ACL, and AI Control Tower records.
Instructions
Create a server in ServiceNow MCP Server Console (sn_mcp_server_registry), optionally with tools attached. The endpoint is /sncapps/mcp-server/mcp/. A draft server creates only the registry row. When the server is (or later becomes) active, ServiceNow itself auto-creates: an OAuth client in Application Registry named like the server (redirect mcp_redirect.do, JWT tokens), an AutoGen OAuth provider with profile and resource, an AutoGen connection alias with HTTP connection, OAuth 2.0 credential and Workflow Data Fabric mapping, an auth server connection, a default-allow execute ACL named after the endpoint, and AI Control Tower records (product model, CI, digital asset). For an active server this tool waits for those and returns them. Remove everything with sn_mcp_delete_server. REQUIRES WRITE_ENABLED=true and the sn_mcp_server.admin role.
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": {
"label": "<label>"
},
"name": "sn_mcp_create_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Unique server name (lowercase, digits, _ and .). Default: the label as snake_case | |
| label | Yes | Display label, e.g. "Service desk tools" | |
| tools | No | Existing tool definition names or sys_ids to attach, e.g. ["sn_mcp_server.incident_summarization"] | |
| status | No | Default draft. active publishes the endpoint and triggers the OAuth / ACL / AI Control Tower setup | |
| description | No | Short description MCP clients see (default: the label) | |
| wait_seconds | No | How long to wait for the auto-created OAuth/ACL records of an active server (default 30, max 120) |