now-ai-kit - your all in one servicenow tool for AI - #1
Merged
Conversation
…itecture - Restructure tools into 13 domain modules (incident, problem, change, task, knowledge, catalog, user, reporting, ATF, Now Assist, scripting, agile, core) - Add role-based tool packaging via MCP_TOOL_PACKAGE (10 packages) - Implement four-tier permission system (write, CMDB write, scripting, Now Assist) - Add 97 new tools across all ITSM, ITOM, and platform domains - Integrate Zurich release APIs: Now Assist Agentic Playbooks, ATF Failure Insight, AI Search, Predictive Intelligence, Performance Analytics, Stats API - Add OAuth 2.0 and Basic Auth support for all six AI clients - Add client configs for Claude Desktop, Cursor, VS Code (basic + OAuth variants) - Add Python integration clients for OpenAI Codex and Google Gemini/Vertex AI - Add comprehensive documentation: TOOLS.md, CLIENT_SETUP.md, TOOL_PACKAGES.md, NOW_ASSIST.md, ATF.md, SCRIPTING.md, REPORTING.md, MULTI_INSTANCE.md - Add per-client SETUP.md guides for all six supported platforms - Add 41 Vitest tests covering permissions, routing, incident, and core tools - Bump version to 2.0.0
…nd 105 examples
- Rename package to now-ai-kit with enriched keywords and repository metadata
- Add 4 new tool modules: HRSD (12 tools), CSM (11 tools), Security/GRC (11 tools),
Flow Designer & Process Automation (10 tools) — total now 154 tools across 17 modules
- Add 20 new unit tests across hrsd.test.ts and security.test.ts — total 61 tests
- Create docs/assets/banner.svg — professional SVG hero banner with gradient,
stat counters (154 tools, 17 modules, 61 tests, 100+ examples, 6 AI clients)
- Rewrite README.md as now-ai-kit with:
- SVG banner and shields.io badge row
- Three-column value proposition table
- Full 17-module coverage table
- Four-tier permission system reference
- Role-based tool package table (10 packages)
- Quick start for Claude Desktop, Claude Code, and Cursor
- 10 plain-language example interactions
- Supported AI clients table (6 clients)
- v2.0 changelog summary
- Project structure tree
- Expand EXAMPLES.md from 19 to 105 real-world examples covering all 17 modules:
HRSD, CSM, SecOps/GRC, Flow Designer, incident triage, change with CAB approval,
security incident response, onboarding, ATF, reporting, KB, agile, Now Assist,
CMDB dependency maps, scripting, multi-instance, catalog, and more
- Replace npm version + tests badges with downloads (200+) and live forks count
- Expand Why now-ai-kit from 3 to 6 value proposition columns:
added Multi-Instance Management, Four-Tier Permission Control,
and Role-Based Tool Packages as dedicated columns
- Remove tool count column from Module Coverage table
…oughout Replace all "Zurich" release mentions across docs and source with neutral language — "latest release", "latest API references", "ServiceNow API" etc. Removes coupling to a specific ServiceNow release name from all user-facing documentation, tool descriptions, inline comments, and the SVG banner.
Add tsconfig.eslint.json that includes tests/ directory, fixing the "TSConfig does not include this file" ESLint parse error. Also remove unused ServiceNowError import in hrsd.test.ts to clear the no-unused-vars error.
Contributor
Author
|
Version 2.0.0 with latest and greatest features expanding the coverage across the platform. |
habenani
pushed a commit
that referenced
this pull request
Aug 18, 2026
…ing 403 diagnostic; don't retry 403
Verified on demo2 with a real data policy. A conditionally-mandatory/read-only field returns HTTP 403
message 'Operation Failed' with the real reason in error.detail ('Data Policy Exception: The following
fields are mandatory: X'). We were discarding detail and leading the 403 checklist with 'missing role'
- misleading even for admin (all roles), and it explains same-user intermittent failures.
- capture error.detail alongside error.message (request path + attachment upload)
- reframe forbiddenDiagnostic: read the specific reason first; data policy / field ACL is cause #1,
with a note that it can fail for the same user depending on the fields sent
- add INSUFFICIENT_PRIVILEGES (403) to the no-retry list -> fails fast (~1s) instead of ~7.7s of retries
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
now-ai-kit is the most advanced, comprehensive, and thoroughly tested ServiceNow MCP server available. It provides complete coverage across all major ServiceNow modules using the latest ServiceNow API references, with seamless, production-ready integration across all major AI providers and SDKs.