Skip to main content

ServiceNow Platform MCP server

Integrate ServiceNow with AI agents to automate IT service management, workflow orchestration, data management, and reporting across the platform. An AI agent connected to ServiceNow can create and manage incidents, process changes, handle service requests, update configuration records, search knowledge, generate analytics, and orchestrate automated remediation—all from natural language requests. Use this for enterprise IT operations automation, intelligent ticketing systems, knowledge-driven support, compliance automation, or cross-module workflow coordination.

Setting up an MCP server

This article covers the standard steps for creating an MCP server in AI Gateway and connecting it to an AI client. The steps are the same for every integration — application-specific details (API credentials, OAuth endpoints, and scopes) are covered in the individual application pages.

Before you begin​

You'll need:

  • Access to AI Gateway with permission to create MCP servers
  • API credentials for the application you're connecting (see the relevant application page for what to collect)

Create an MCP server​

Find the API in the catalog​

  1. Sign in to AI Gateway and select MCP Servers from the left navigation.
  2. Select New MCP Server.
  3. Search for the application you want to connect, then select it from the catalog.

Configure the server​

  1. Enter a Name for your server — something descriptive that identifies both the application and its purpose (for example, "Zendesk Support — Prod").
  2. Enter a Description so your team knows what the server is for.
  3. Set the Timeout value. 30 seconds works for most APIs; increase to 60 seconds for APIs that return large payloads.
  4. Toggle Production mode on if this server will be used in a live workflow.
  5. Select Next.

Configure authentication​

Enter the authentication details for the application. This varies by service — see the Authentication section of the relevant application page for the specific credentials, OAuth URLs, and scopes to use.

Configure security​

  1. Set any Rate limits appropriate for your use case and the API's own limits.
  2. Enable Logging if you want AI Gateway to record requests and responses for auditing.
  3. Select Next.

Deploy​

Review the summary, then select Deploy. AI Gateway provisions the server and provides a server URL you'll use when configuring your AI client.

Connect to an AI client​

Once your server is deployed, you'll need to add it to the AI client your team uses. Select your client for setup instructions:

Tips​

  • You can create multiple MCP servers for the same application — for example, a read-only server for reporting agents and a read-write server for automation workflows.
  • If you're unsure which OAuth scopes to request, start with the minimum read-only set and add write scopes only when needed. Most application pages include scope recommendations.
  • You can edit a server's name, description, timeout, and security settings after deployment without redeploying.

Authentication​

ServiceNow integration uses OAuth 2.0 authentication. When you register an OAuth application in your ServiceNow instance, you'll receive authorization and token endpoints in the pattern https://{instance}.service-now.com/oauth_auth.do and https://{instance}.service-now.com/oauth_token.do. You'll need your client ID and client secret to configure the MCP server. ServiceNow OAuth uses a default scope called useraccount which provides access to user account information and standard API operations. Additional scopes can be configured for granular permissions across specific tables or operations.

Available tools​

These tools enable ticket management, configuration control, service catalog operations, CMDB management, knowledge access, and reporting across all ServiceNow modules.

ToolDescription
Create ticketCreate incident, change, problem, or service request
Get ticketRetrieve ticket details and metadata
Update ticketModify ticket status, fields, or assignments
List ticketsQuery tickets with advanced filtering
Search ticketsFull-text search across all ticket types
Create changeSubmit change requests with impact assessment
Approve changeApprove or reject pending changes
Get CIRetrieve configuration item details
Update CIModify CI attributes and relationships
List CIsQuery CMDB items by type or status
Create catalog requestSubmit service catalog requests
Get catalog requestRetrieve request details and fulfillment status
List catalog itemsBrowse available services
Search knowledgeQuery knowledge base articles
Get articleRetrieve full knowledge article
Generate reportCreate standard or custom reports
Execute workflowTrigger automated remediation or approval workflows

Tips​

Design workflows with clear approval chains and escalation paths so the agent understands governance and can navigate complex approval processes.

Keep the CMDB accurate and up-to-date since many automated decisions depend on it being current and consistent.

Create knowledge articles for all common procedures to enable self-service by the agent and reduce unnecessary ticket creation.

Use consistent field naming and choice list values across tables for reliable automation and easier data integration.

Monitor API rate limits to avoid throttling errors when making bulk API calls.

Batch large operations to balance load and improve throughput when processing many records.