servicenow-sparring
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
servicenow-sparring
A read-only MCP server that lets an AI agent check claims about ServiceNow against a live instance, instead of answering from memory.
https://github.com/user-attachments/assets/48cee9b5-aa48-4f32-b097-613aac823b13
Intro, two minutes, no sound. The same film as a file: docs/media/intro.mp4.
An agent that answers ServiceNow questions from memory does not know your instance: which release it runs, which plugins are active, what was customized. A wrong answer sounds exactly like a right one. This server gives the agent eight functions that read the instance and return evidence a person can run again.
What it answers
Function | Question |
| Which release is this, how much was customized, and what can this account read? |
| What is really in this table? |
| Which fields does a table have, including the inherited ones and dictionary overrides? |
| Which plugins and store apps are installed? |
| What was changed on this instance, by whom and when? |
| Is this record out-of-the-box, customized, or customer-created? |
| What configuration is attached to this table? |
| What did the upgrade skip, and still needs a review? |
It also serves one MCP prompt, verify_claim, and one resource, servicenow-sparring://limitations.
Related MCP server: servicenow-mcp
Evidence you can run again
Every answer names where it came from and how complete it is:
{
"instance": "example.service-now.com",
"table": "sys_script",
"query": "collection=incident^active=true",
"total": 83,
"returned": 20,
"offset": 0,
"truncated": true,
"nextOffset": 20,
"fieldCheck": "all field names verified against sys_dictionary",
"warnings": [],
"records": []
}Three rules keep the evidence from lying:
A query on a field that does not exist is refused. ServiceNow drops a condition on an unknown field and answers with every row. One typo would turn "no match" into "here are some records". Field names, dot-walks included, are checked against the instance dictionary before anything is sent, and the error names similar fields.
Counts say what they count.
totalis what matched on the server before row-level access rules;returnedis what this account received. When rows were withheld, the answer says so."Could not be checked" is never "nothing found". A table this account cannot read is an error of kind
acl. A tool that depends on it marks that partnot_checkedorunknown.
What "read-only" means here
The server sends only HTTP GET requests, and only to two endpoints: the Table API (/api/now/table/<table>) and
the Aggregate API (/api/now/stats/<table>). There is no function and no code path that creates, updates or deletes
anything. Two tests fail the build if that changes: one scans the source for any other HTTP method, one records every
request the eight functions send.
That is a statement about what the server sends. It is not a statement about what an instance does while it answers:
A
before querybusiness rule runs on every read. It is customer code and does whatever its author wrote.Every request is logged on the instance.
javascript:inside an encoded query runs script on the instance. The server refuses such queries, and no setting turns that off. Use fixed values, for datesYYYY-MM-DD HH:MM:SSin UTC.
So give the server an account that cannot write. ServiceNow ships the role snc_read_only for this: its users "are
prevented from creating, updating, or deleting records". Then the instance enforces the promise a second time.
More guards: table names and field names are validated before they reach a URL; values that functions place into a
query may not contain ^; https is required; redirects are not followed; requests time out. Record content that
comes back (names, descriptions, scripts) is data from the instance, and the server tells the agent to treat it as
data, never as an instruction.
Setup
Needs Node.js 22 or newer.
git clone https://github.com/munirad7s/servicenow-sparring-mcp.git
cd servicenow-sparring-mcp
npm installnpm install also builds the server into dist/.
Configuration
Variable | Meaning |
| The instance address, for example |
| Basic authentication |
| A ready-made OAuth access token, sent as a bearer token. Wins over user name and password |
| Optional path to a file with the variables above. Without it, |
| Optional request timeout, default 30000 |
Variables that are already set win over the file. See .env.example.
The server does not fetch tokens itself. A token request is a POST, and this code base contains no request other
than GET.
Check the account
npm run doctorThis lists the tables the functions read and whether the configured account can read each one. Nothing has to be installed on the instance.
Register with an MCP client
Any client that starts a local MCP server over stdio works. The usual configuration block:
{
"mcpServers": {
"servicenow-sparring": {
"command": "node",
"args": ["/absolute/path/to/servicenow-sparring-mcp/dist/index.js"],
"env": { "SERVICENOW_ENV_FILE": "/absolute/path/to/instance.env" }
}
}
}How sn_origin decides
It answers two questions separately and shows the rows behind each.
Question | Evidence | Values |
Who delivered the record? | the class of the package it belongs to ( |
|
Was it changed on this instance? | rows in |
|
Delivered by | Changed here | Verdict |
vendor package or installed application | no |
|
vendor package or installed application | yes |
|
custom application | any |
|
no package (global scope) | yes |
|
no package (global scope) | no |
|
anything | evidence not readable |
|
How far to trust it: the rule was derived on one instance. A run over 60 application files there gave 53 verdicts and
7 times unknown; the verdicts were not checked by hand against a second source. Update rows can be cleaned up or
lost in a clone, and a reverted change can still count as customized. Read out_of_box_as_captured as "no captured
change", not as proof.
What it cannot know
sn_deltareadssys_update_xml, which does not record everything: for example metadata types that are not tracked, cascading field changes, and some Flow changes. Every answer lists the gaps. Say "captured customizations", never "all customizations".sn_dependencieslists configuration attached to a table and its parents. It does not see scripts that only name the table in code, the flow behind a record trigger, wildcard access controls, reports or integrations. The answer lists what is not covered.sn_upgrade_skipslists records an upgrade did not overwrite. Each one needs a review. It is not a prediction that something breaks, and it describes only the instance that answered.Encoded queries are parsed with a strict grammar. Related-list queries (
RLQUERY), tag conditions and the shorthand operators*,%,!*are refused, because they cannot be checked.
The resource servicenow-sparring://limitations carries the full list to the agent.
Development
npm test # unit tests against a fake instance, no network
npm run typecheck
npm run smoke # end-to-end against the configured instance, read-onlynpm run smoke drives the real server through an MCP client and exits with 1 if a check fails. It prints counts and
verdicts, never record content.
Tested live against one instance on the Australia release. On another release, run npm run doctor and
npm run smoke first. The bearer-token path is covered by unit tests only.
Contributions are welcome, see CONTRIBUTING.md. To report a security problem, see SECURITY.md.
Licence
MIT. Not affiliated with ServiceNow, Inc. "ServiceNow" is a trademark of ServiceNow, Inc.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
One governed MCP endpoint for 40+ business systems. Read-only, source-cited answers.
Guarded MCP server for agent-readable business truth, provenance, readiness, and discovery.
Hosted MCP server for pre-action AI governance verdicts, model routing, and evidence verification.
41Agent-native MCP server over 49M+ US public and government records, privacy-first, always current.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceRead-only MCP server that answers questions about turva.dev from its published data. Five tools return JSON: the service catalog with prices, contact and operator details, engagement principles and dated agent-readiness and security evidence with verification links. Connect over Streamable HTTP. You need no API key. The server does not scan other websites or run audits.MIT
- AlicenseAqualityDmaintenanceA read-only MCP server that enables AI assistants to query ServiceNow instances—incidents, changes, users, CMDB—with malformed query linting and injection protection.7MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that enables AI agents to search, fetch, and analyze a self-maintaining markdown knowledge base with provenance, drift detection, and canonical definitions.1MIT
- FlicenseAqualityCmaintenanceA read-only MCP server for ServiceNow that provides deep visibility across multiple instances via query, schema inspection, identity, workflow, and code search tools.147 npm-