ServiceNow MCP Server (SSE - Browser Accessible)

A browser-accessible Model Context Protocol (MCP) server for ServiceNow incident management using Server-Sent Events (SSE) transport.

🌟 Key Features

• ✅ Browser Accessible - Access via HTTP/SSE from any browser
• ✅ AI Assistant Compatible - Works with Bob, Claude, and other MCP clients
• ✅ Four ServiceNow Tools - Complete incident management (get, list, create, update)
• ✅ RESTful Health Checks - Monitor server status
• ✅ CORS Enabled - Cross-origin requests supported
• ✅ Type-Safe - Full TypeScript implementation with Zod validation

🆚 Difference from Stdio Version

| Feature | Stdio Server | SSE Server (This One) | |---------|--------------|----------------------| | Browser Access | ❌ No | ✅ Yes | | AI Assistant Access | ✅ Yes | ✅ Yes | | HTTP Endpoints | ❌ No | ✅ Yes | | Port Required | ❌ No | ✅ Yes (3000) | | Testing | Command line only | Browser, curl, Postman | | Use Case | AI assistants only | Browsers + AI assistants |

📦 Installation

Prerequisites

• Node.js v18+ (you have v24.14.0 ✅)
• npm
• ServiceNow instance with API access

Setup

1. Install dependencies:

   cd servicenow-server-sse
   /usr/local/bin/npm install
   

2. Build the server:

   /usr/local/bin/npm run build
   

3. Set environment variables:

   export SERVICENOW_INSTANCE_URL="https://your-instance.service-now.com"
   export SERVICENOW_USERNAME="your-username"
   export SERVICENOW_PASSWORD="your-password"
   export PORT=3000  # Optional, defaults to 3000
   

4. Start the server:

   /usr/local/bin/npm start
   

🚀 Quick Start

Start the Server

# Set credentials
export SERVICENOW_INSTANCE_URL="https://dev12345.service-now.com"
export SERVICENOW_USERNAME="admin"
export SERVICENOW_PASSWORD="your-password"

# Start server
cd servicenow-server-sse
/usr/local/bin/npm start

You should see:

🚀 ServiceNow MCP Server (SSE) running on http://localhost:3000
📡 SSE endpoint: http://localhost:3000/sse
💚 Health check: http://localhost:3000/health
📖 API info: http://localhost:3000/
🔗 ServiceNow instance: https://dev12345.service-now.com

🌐 Browser Access

Health Check

Open in browser: http://localhost:3000/health

Response:

{
  "status": "healthy",
  "server": "servicenow-server-sse",
  "version": "0.1.0",
  "servicenow_instance": "https://your-instance.service-now.com"
}

API Information

Open in browser: http://localhost:3000/

Shows available tools and endpoints.

SSE Connection

The MCP protocol endpoint: http://localhost:3000/sse

This is used by MCP clients (AI assistants) to connect.

🛠️ Available Tools

1. get_incident

Retrieve incident details by number or sys_id.

Parameters:

• incident_id (required): Incident number (e.g., "INC0010001") or sys_id

Example:

{
  "incident_id": "INC0010001"
}

2. list_incidents

Query incidents with filters and pagination.

Parameters:

• state (optional): 1=New, 2=In Progress, 3=On Hold, 6=Resolved, 7=Closed
• priority (optional): 1=Critical, 2=High, 3=Moderate, 4=Low, 5=Planning
• assigned_to (optional): User sys_id or username
• assignment_group (optional): Group sys_id or name
• caller_id (optional): Caller sys_id or username
• created_after (optional): ISO 8601 date
• created_before (optional): ISO 8601 date
• limit (optional): 1-100, default 10
• offset (optional): Pagination offset, default 0

Example:

{
  "state": "2",
  "priority": "1",
  "limit": 20
}

3. create_incident

Create a new incident.

Parameters:

• short_description (required): Brief description
• caller_id (required): Caller sys_id or username
• description (optional): Detailed description
• urgency (optional): 1=High, 2=Medium, 3=Low
• impact (optional): 1=High, 2=Medium, 3=Low
• priority (optional): 1-5
• assignment_group (opt

... View full README on GitHub