servicenow-api

MCP运维云端

提供方 Knuckles-Team · 包名 servicenow-api

运维云端 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

ServiceNow MCP Server and API Wrapper

一句话选型结论

按资料字段整理

servicenow-api 属于运维云端类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 17 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

a2a a2a-server ag-ui mcp mcp-server

支持客户端

适用场景

a2aa2a-serverag-ui

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
pip install servicenow-api

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
servicenow-api当前 未标注 stdio · 本地进程 本地部署 有 2026-04-20
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Knuckles-Team上游标注的维护方 Knuckles-Team
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时servicenow-api · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-20上游最后核验时间

详细介绍

44.3 KB
来自项目仓库与上游目录的原文,未做删改

Servicenow Api

CLI or API · MCP · Agent

> Documentation — Installation, deployment, and usage across the API, CLI, MCP,
> and A2A agent interfaces are maintained in the
> official documentation.


Overview

Servicenow Api is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with Python ServiceNow API Wrapper.


Key Features

  • Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
  • Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
  • Integrated Graph Agent: Built-in Pydantic AI agent supporting the Agent Control Protocol (ACP) and standard Web interfaces (AG-UI).
  • Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.

CLI or API

This agent wraps the Python ServiceNow API Wrapper API. The operator can interact with it programmatically or via its integrated execution entrypoints.

Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.


MCP

This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.

Tool surface — MCP_TOOL_MODE

Set MCP_TOOL_MODE (in the shared ~/.config/agent-connector-sdk/config.json or env) to choose the surface:

  • condensed (default) — the action-routed tools below (servicenow_(action, params_json)).
  • verbose — one named, documented 1:1 tool per API method (servicenow_get_cmdb_instance(...)), tagged verbose.
  • both — register both sets.

Filter the verbose set with --tools tag:verbose / MCP_ENABLED_TAGS=verbose. See the
agent-connector-sdk guide MCP Tool Modes for details.

Available MCP Tools

The table below is auto-generated from the MCP server — do not edit by hand.

Condensed action-routed tools (MCP_TOOL_MODE=condensed)

MCP Tool Toggle Env Var Description
servicenow_account ACCOUNTTOOL Manage servicenow account operations.
servicenow_activity_subscriptions ACTIVITY_SUBSCRIPTIONSTOOL Manage servicenow activity subscriptions operations.
servicenow_aggregate AGGREGATETOOL Manage servicenow aggregate operations.
servicenow_application APPLICATIONTOOL Manage servicenow application operations.
servicenow_attachment ATTACHMENTTOOL Manage servicenow attachment operations.
servicenow_auth AUTHTOOL Manage servicenow auth operations.
servicenow_batch BATCHTOOL Manage servicenow batch operations.
servicenow_change_management CHANGE_MANAGEMENTTOOL Manage servicenow change management operations.
servicenow_cicd CICDTOOL Manage servicenow cicd operations.
servicenow_cilifecycle CILIFECYCLETOOL Manage servicenow cilifecycle operations.
servicenow_cmdb CMDBTOOL Manage servicenow cmdb operations.
servicenow_custom_api CUSTOM_APITOOL Manage servicenow custom api operations.
servicenow_data_classification DATA_CLASSIFICATIONTOOL Manage servicenow data classification operations.
servicenow_devops DEVOPSTOOL Manage servicenow devops operations.
servicenow_email EMAILTOOL Manage servicenow email operations.
servicenow_flows FLOWSTOOL Manage servicenow flows operations.
servicenow_hr HRTOOL Manage servicenow hr operations.
servicenow_import_sets IMPORT_SETSTOOL Manage servicenow import sets operations.
servicenow_incidents INCIDENTSTOOL Manage servicenow incidents operations.
servicenow_ingest_incidents MISCTOOL Natively ingest ServiceNow incidents into epistemic-graph as typed :Incident nodes.
servicenow_knowledge_management KNOWLEDGE_MANAGEMENTTOOL Manage servicenow knowledge management operations.
servicenow_metricbase METRICBASETOOL Manage servicenow metricbase operations.
servicenow_plugins PLUGINSTOOL Manage servicenow plugins operations.
servicenow_ppm PPMTOOL Manage servicenow ppm operations.
servicenow_problem PROBLEMTOOL Manage servicenow problem management operations.
servicenow_product_inventory PRODUCT_INVENTORYTOOL Manage servicenow product inventory operations.
servicenow_sdk SDKTOOL Scaffold, build, and deploy a ServiceNow Studio scoped app via the now-sdk CLI.
servicenow_service_qualification SERVICE_QUALIFICATIONTOOL Manage servicenow service qualification operations.
servicenow_source_control SOURCE_CONTROLTOOL Manage servicenow source control operations.
servicenow_table_api TABLE_APITOOL Manage servicenow table api operations.
servicenow_testing TESTINGTOOL Manage servicenow testing operations.
servicenow_update_sets UPDATE_SETSTOOL Manage servicenow update sets operations.

Verbose 1:1 API-mapped tools (MCP_TOOL_MODE=verbose or both)

126 per-operation tools — one per public API method (click to expand)

MCP Tool Toggle Env Var Description
servicenow_activate_plugin DEVOPSTOOL Activate a plugin based on the provided plugin_id.
servicenow_add_ci_lifecycle_action CMDBTOOL Adds a specified CI action to a specified list of CIs.
servicenow_add_table_record SYSTEMTOOL Add a new record to the specified table.
servicenow_api_request SYSTEMTOOL Invoke the api_request operation.
servicenow_app_repo_install DEVOPSTOOL Install an application from the repository based on the provided parameters.
servicenow_app_repo_publish DEVOPSTOOL Publish an application to the repository based on the provided parameters.
servicenow_app_repo_rollback DEVOPSTOOL Rollback an application in the repository based on the provided parameters.
servicenow_apply_remote_source_control_changes OTHERTOOL Apply remote source control changes based on the provided parameters.
servicenow_approve_change_request CHANGETOOL Approve or reject a change request.
servicenow_batch_install OTHERTOOL Initiate a batch installation with the provided parameters.
servicenow_batch_install_result OTHERTOOL Get the result of a batch installation based on the provided result ID.
servicenow_batch_request OTHERTOOL Sends multiple REST API requests in a single call.
servicenow_batch_rollback OTHERTOOL Rollback a batch installation based on the provided rollback ID.
servicenow_calculate_standard_change_request_risk CHANGETOOL Calculate and update the risk of a standard change request.
servicenow_check_change_request_conflict CHANGETOOL Check for conflicts in a change request.
servicenow_check_ci_lifecycle_compat_actions CMDBTOOL Determines whether two specified CI actions are compatible.
servicenow_check_ci_lifecycle_lease_expired CMDBTOOL Determines whether the lease has expired for the requester.
servicenow_check_ci_lifecycle_not_allowed_action CMDBTOOL Determines whether a specified CI action is not allowed.
servicenow_check_ci_lifecycle_not_allowed_ops_transition CMDBTOOL Determines whether an operational state transition is allowed.
servicenow_check_ci_lifecycle_requestor_valid CMDBTOOL Determines whether the specified user is a valid requester.
servicenow_check_devops_change_control DEVOPSTOOL Checks if the orchestration task is under change control.
servicenow_check_devops_step_mapping DEVOPSTOOL Verifies that the information being passed is valid for the creation of an orchestration task.
servicenow_check_service_qualification OTHERTOOL Creates a technical service qualification request.
servicenow_collect_graph_for_roots CMDBTOOL Invoke the collect_graph_for_roots operation.
servicenow_combo_suite_scan OTHERTOOL Initiate a suite scan for a combo based on the provided combo_sys_id.
servicenow_create_change_request CHANGETOOL Create a new change request.
servicenow_create_change_request_ci_association CHANGETOOL Create associations between a change request and configuration items (CIs).
servicenow_create_change_request_task CHANGETOOL Create a new task associated with a change request.
servicenow_create_cmdb_instance CMDBTOOL Creates a single configuration item (CI).
servicenow_create_cmdb_relation CMDBTOOL Adds an inbound and/or outbound relation to the specified CI.
servicenow_create_incident INCIDENTTOOL Create a new incident record.
servicenow_create_problem PROBLEMTOOL Create a new problem record.
servicenow_delete_attachment OTHERTOOL Invoke the delete_attachment operation.
servicenow_delete_change_request CHANGETOOL Delete a change request.
servicenow_delete_change_request_conflict_scan CHANGETOOL Delete conflict scan information associated with a change request.
servicenow_delete_change_request_task CHANGETOOL Delete a task associated with a change request.
servicenow_delete_ci_lifecycle_action CMDBTOOL Removes a configuration item (CI) action for a list of CIs.
servicenow_delete_cmdb_relation CMDBTOOL Deletes the relation for the specified configuration item (CI).
servicenow_delete_incident INCIDENTTOOL Delete an incident record.
servicenow_delete_problem PROBLEMTOOL Delete a problem record.
servicenow_delete_product_inventory OTHERTOOL Deletes a specified product inventory record.
servicenow_delete_table_record SYSTEMTOOL Delete a record from the specified table.
servicenow_extend_ci_lifecycle_lease CMDBTOOL Extends the specified CI action's lease expiration time.
servicenow_full_scan OTHERTOOL Initiate a full instance scan.
servicenow_get_account OTHERTOOL Invoke the get_account operation.
servicenow_get_activity_subscriptions OTHERTOOL Invoke the get_activity_subscriptions operation.
servicenow_get_application OTHERTOOL Get information about an application.
servicenow_get_attachment OTHERTOOL Invoke the get_attachment operation.
servicenow_get_change_request CHANGETOOL Retrieve details of a specific change request.
servicenow_get_change_request_ci CHANGETOOL Retrieve the configuration item (CI) associated with a change request.
servicenow_get_change_request_conflict CHANGETOOL Retrieve conflict information associated with a change request.
servicenow_get_change_request_models CHANGETOOL Retrieve change request models based on specified parameters.
servicenow_get_change_request_nextstate CHANGETOOL Retrieve the next state of a specific change request.
servicenow_get_change_request_schedule CHANGETOOL Retrieve the schedule of a change request based on CI sys ID.
servicenow_get_change_request_tasks CHANGETOOL Retrieve tasks associated with a specific change request.
servicenow_get_change_request_worker CHANGETOOL Retrieve details of a change request worker.
servicenow_get_change_requests CHANGETOOL Retrieve change requests based on specified parameters.
servicenow_get_ci_lifecycle_active_actions CMDBTOOL Returns a list of active CI actions for the specified CI.
servicenow_get_ci_lifecycle_status CMDBTOOL Returns the current operational state for the specified CI.
servicenow_get_cmdb CMDBTOOL Get Configuration Management Database (CMDB) information based on specified parameters.
servicenow_get_cmdb_instance CMDBTOOL Returns attributes and relationship information for a specified CI record.
servicenow_get_cmdb_instances CMDBTOOL Returns the available configuration items (CI) for a specified CMDB class.
servicenow_get_data_classification OTHERTOOL Invoke the get_data_classification operation.
servicenow_get_devops_change_info DEVOPSTOOL Retrieves change request details for a specified orchestration pipeline execution.
servicenow_get_devops_code_schema DEVOPSTOOL Returns the schema object for a specified code resource.
servicenow_get_devops_onboarding_status DEVOPSTOOL Returns the current status of the specified onboarding event.
servicenow_get_devops_orchestration_schema DEVOPSTOOL Returns the schema object for a specified orchestration resource.
servicenow_get_devops_plan_schema DEVOPSTOOL Returns the schema object for a specific plan.
servicenow_get_featured_knowledge_article KNOWLEDGETOOL Get featured Knowledge Base articles.
servicenow_get_flow_metadata SYSTEMTOOL Fetch rich metadata for any flow/subflow.
servicenow_get_hr_profile OTHERTOOL Invoke the get_hr_profile operation.
servicenow_get_import_set OTHERTOOL Get details of a specific import set record.
servicenow_get_incident INCIDENTTOOL Retrieve details of a specific incident record.
servicenow_get_incidents INCIDENTTOOL Retrieve details of incident records.
servicenow_get_knowledge_article KNOWLEDGETOOL Get Knowledge Base article.
servicenow_get_knowledge_article_attachment KNOWLEDGETOOL Get Knowledge Base article attachment.
servicenow_get_knowledge_articles KNOWLEDGETOOL Get all Knowledge Base articles.
servicenow_get_most_viewed_knowledge_articles KNOWLEDGETOOL Get most viewed Knowledge Base articles.
servicenow_get_problem PROBLEMTOOL Retrieve details of a specific problem record.
servicenow_get_problems PROBLEMTOOL Retrieve details of problem records.
servicenow_get_product_inventory OTHERTOOL Retrieves a list of all product inventories.
servicenow_get_service_qualification OTHERTOOL Retrieves a technical qualification request by ID or list all.
servicenow_get_standard_change_request_model CHANGETOOL Retrieve details of a standard change request model.
servicenow_get_standard_change_request_template CHANGETOOL Retrieve details of a standard change request template.
servicenow_get_standard_change_request_templates CHANGETOOL Retrieve standard change request templates based on specified parameters.
servicenow_get_stats SYSTEMTOOL Invoke the get_stats operation.
servicenow_get_table SYSTEMTOOL Get records from the specified table based on provided parameters.
servicenow_get_table_record SYSTEMTOOL Get a specific record from the specified table.
servicenow_import_repository DEVOPSTOOL Import a repository based on the provided parameters.
servicenow_ingest_cmdb_data CMDBTOOL Inserts records into the Import Set table associated with the data source.
servicenow_insert_cost_plans OTHERTOOL Creates cost plans.
servicenow_insert_import_set OTHERTOOL Insert a new record into the specified import set.
servicenow_insert_multiple_import_sets OTHERTOOL Insert multiple records into the specified import set.
servicenow_insert_project_tasks OTHERTOOL Creates a project and associated project tasks.
servicenow_instance_scan_progress OTHERTOOL Get progress information for an instance scan based on the provided progress ID.
servicenow_metricbase_insert OTHERTOOL Invoke the metricbase_insert operation.
servicenow_patch_cmdb_instance CMDBTOOL Replaces attributes in the specified CI record (PATCH).
servicenow_patch_table_record SYSTEMTOOL Partially update a record in the specified table.
servicenow_point_scan OTHERTOOL Initiate a point instance scan based on the provided parameters.
servicenow_process_service_qualification_result OTHERTOOL Processes a technical service qualification result.
servicenow_progress OTHERTOOL Get progress information based on the provided progress ID.
servicenow_refresh_auth_token SYSTEMTOOL Refresh the authentication token
servicenow_refresh_change_request_impacted_services CHANGETOOL Refresh impacted services for a change request.
servicenow_register_ci_lifecycle_operator CMDBTOOL Registers an operator for a non-workflow user.
servicenow_register_devops_artifact DEVOPSTOOL Enables orchestration tools to register artifacts into a ServiceNow instance.
servicenow_rollback_plugin DEVOPSTOOL Rollback a plugin based on the provided plugin_id.
servicenow_run_test_suite OTHERTOOL Run a test suite based on the provided parameters.
servicenow_send_email SYSTEMTOOL Invoke the send_email operation.
servicenow_set_ci_lifecycle_status CMDBTOOL Sets the operational state for a specified list of CIs.
servicenow_suite_scan OTHERTOOL Initiate a suite scan based on the provided suite_sys_id and sys_ids.
servicenow_unregister_ci_lifecycle_operator CMDBTOOL Unregisters an operator for non-workflow users.
servicenow_update_change_request CHANGETOOL Update details of a change request.
servicenow_update_change_request_first_available CHANGETOOL Update the schedule of a change request to the first available slot.
servicenow_update_change_request_task CHANGETOOL Update details of a task associated with a change request.
servicenow_update_cmdb_instance CMDBTOOL Updates the specified CI record (PUT).
servicenow_update_incident INCIDENTTOOL Update an existing incident record.
servicenow_update_problem PROBLEMTOOL Update an existing problem record.
servicenow_update_set_back_out DEVOPSTOOL Backs out an installation operation that was performed on an update set with a given sys_id.
servicenow_update_set_commit DEVOPSTOOL Commits an update set with a given sys_id.
servicenow_update_set_commit_multiple DEVOPSTOOL Commits multiple update sets in a single request according to the order that they're provided.
servicenow_update_set_create DEVOPSTOOL Creates a new update set and inserts the new record in the Update Sets [sys_update_set] table.
servicenow_update_set_preview DEVOPSTOOL Previews an update set to check for any conflicts and retrieve progress information about the update set operation.
servicenow_update_set_retrieve DEVOPSTOOL Retrieves an update set with a given sys_id and allows you to remove the existing retrieved update set from the instance.
servicenow_update_table_record SYSTEMTOOL Fully update a record in the specified table.
servicenow_upload_attachment OTHERTOOL Upload a file as an attachment on a table record.
servicenow_workflow_to_mermaid SYSTEMTOOL Generates a Mermaid diagram representing the relationships between ServiceNow flows and subflows.

32 action-routed tool(s) · 126 verbose 1:1 tool(s). Each is enabled unless its TOOL toggle is set false; MCP_TOOL_MODE selects the surface (intent default — the six verb-tools, granular set loaded on demand · condensed action-routed · verbose 1:1 · both). Auto-generated — do not edit.

Detailed tool schemas, parameter shapes, and validation constraints are preserved in docs/usage.md.

Dynamic Tool Selection & Visibility

This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.

The operator can configure tool filtering via multiple input channels:

  • CLI Arguments: Pass --tools or --toolsets (or their disabled counterparts --disabled-tools and --disabled-toolsets) during startup.
  • Environment Variables: Define standard environment variables:
  • MCP_ENABLED_TOOLS / MCP_DISABLED_TOOLS
  • MCP_ENABLED_TAGS / MCP_DISABLED_TAGS
  • HTTP SSE Request Headers: Pass custom headers during transport initialization:
  • x-mcp-enabled-tools / x-mcp-disabled-tools
  • x-mcp-enabled-tags / x-mcp-disabled-tags
  • HTTP SSE Request Query Parameters: Append query parameters directly to the operator's transport connection URL:
  • ?tools=tool1,tool2
  • ?tags=tag1

When query strings or parameters are provided, an LLM-free Knowledge Graph resolution layer (using DynamicToolOrchestrator) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.


MCP Configuration Examples

> Install the connector-focused [mcp] extra. Examples use servicenow-api[mcp] to add
> FastMCP / FastAPI through agent-connector-sdk[mcp]; the required Agent Utilities core
> still carries epistemic-graph[full]. The [agent-runtime] extra additionally
> enables model orchestration.

stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)```json

{
"mcpServers": {
"servicenow-mcp": {
"command": "uvx",
"args": [
"--from",
"servicenow-api[mcp]",
"servicenow-mcp"
],
"env": {
"MCP_TOOL_MODE": "intent",
"ACCOUNTTOOL": "True",
"ACTIVITY_SUBSCRIPTIONSTOOL": "True",
"AGGREGATETOOL": "True",
"APPLICATIONTOOL": "True",
"ATTACHMENTTOOL": "True",
"AUTHTOOL": "True",
"BATCHTOOL": "True",
"CHANGE_MANAGEMENTTOOL": "True",
"CICDTOOL": "True",
"CILIFECYCLETOOL": "True",
"CMDBTOOL": "True",
"CUSTOM_APITOOL": "True",
"DATA_CLASSIFICATIONTOOL": "True",
"DELEGATED_SCOPES": "api",
"DEVOPSTOOL": "True",
"EMAILTOOL": "True",
"FLOWSTOOL": "True",
"HRTOOL": "True",
"IMPORT_SETSTOOL": "True",
"INCIDENTSTOOL": "True",
"KNOWLEDGE_MANAGEMENTTOOL": "True",
"METRICBASETOOL": "True",
"MISCTOOL": "True",
"OPENAPI_CLIENT_ID": "your_openapi_client_id_here",
"OPENAPI_CLIENT_SECRET": "your_openapi_client_secret_here",
"OPENAPI_PASSWORD": "your_openapi_password_here",
"OPENAPI_USERNAME": "your_openapi_username_here",
"PLUGINSTOOL": "True",
"PPMTOOL": "True",
"PROBLEMTOOL": "True",
"PRODUCT_INVENTORYTOOL": "True",
"SDKTOOL": "True",
"SDK_WORKDIR": "/data/servicenow-sdk-workspace",
"SERVICENOW_CLIENT_SECRET": "your_servicenow_client_secret_here",
"SERVICENOW_GRANT_TYPE": "password",
"SERVICENOW_INSTANCE": "https://instance.example.invalid",
"SERVICENOW_PASSWORD": "your_servicenow_password_here",
"SERVICENOW_TLS_PROFILE": "system",
"SERVICENOW_USERNAME": "your_servicenow_username_here",
"SERVICE_QUALIFICATIONTOOL": "True",
"SOURCE_CONTROLTOOL": "True",
"TABLE_APITOOL": "True",
"TESTINGTOOL": "True",
"UPDATE_SETSTOOL": "True"
}
}
}
}


Runtime references require an alias-aware launcher such as Arbora. Other
launchers must omit those entries and inject the resolved values through their
own runtime secret boundary.

#### Streamable-HTTP Transport (networked / production)```json
{
  "mcpServers": {
    "servicenow-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "servicenow-api[mcp]",
        "servicenow-mcp",
        "--transport",
        "streamable-http",
        "--port",
        "8000"
      ],
      "env": {
        "TRANSPORT": "streamable-http",
        "HOST": "127.0.0.1",
        "PORT": "8000",
        "MCP_TOOL_MODE": "intent",
        "ACCOUNTTOOL": "True",
        "ACTIVITY_SUBSCRIPTIONSTOOL": "True",
        "AGGREGATETOOL": "True",
        "APPLICATIONTOOL": "True",
        "ATTACHMENTTOOL": "True",
        "AUTHTOOL": "True",
        "BATCHTOOL": "True",
        "CHANGE_MANAGEMENTTOOL": "True",
        "CICDTOOL": "True",
        "CILIFECYCLETOOL": "True",
        "CMDBTOOL": "True",
        "CUSTOM_APITOOL": "True",
        "DATA_CLASSIFICATIONTOOL": "True",
        "DELEGATED_SCOPES": "api",
        "DEVOPSTOOL": "True",
        "EMAILTOOL": "True",
        "FLOWSTOOL": "True",
        "HRTOOL": "True",
        "IMPORT_SETSTOOL": "True",
        "INCIDENTSTOOL": "True",
        "KNOWLEDGE_MANAGEMENTTOOL": "True",
        "METRICBASETOOL": "True",
        "MISCTOOL": "True",
        "OPENAPI_CLIENT_ID": "your_openapi_client_id_here",
        "OPENAPI_CLIENT_SECRET": "your_openapi_client_secret_here",
        "OPENAPI_PASSWORD": "your_openapi_password_here",
        "OPENAPI_USERNAME": "your_openapi_username_here",
        "PLUGINSTOOL": "True",
        "PPMTOOL": "True",
        "PROBLEMTOOL": "True",
        "PRODUCT_INVENTORYTOOL": "True",
        "SDKTOOL": "True",
        "SDK_WORKDIR": "/data/servicenow-sdk-workspace",
        "SERVICENOW_CLIENT_SECRET": "your_servicenow_client_secret_here",
        "SERVICENOW_GRANT_TYPE": "password",
        "SERVICENOW_INSTANCE": "https://instance.example.invalid",
        "SERVICENOW_PASSWORD": "your_servicenow_password_here",
        "SERVICENOW_TLS_PROFILE": "system",
        "SERVICENOW_USERNAME": "your_servicenow_username_here",
        "SERVICE_QUALIFICATIONTOOL": "True",
        "SOURCE_CONTROLTOOL": "True",
        "TABLE_APITOOL": "True",
        "TESTINGTOOL": "True",
        "UPDATE_SETSTOOL": "True"
      }
    }
  }
}

Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:```json
{
"mcpServers": {
"servicenow-mcp": {
"url": "http://localhost:8000/servicenow-mcp/mcp"
}
}
}


Run a reviewed container image as a least-privilege stdio child (no
listener or published port):```bash
docker run -i --rm \
  --read-only \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --pids-limit=256 \
  --tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
  -e TRANSPORT=stdio \
  -e MCP_TOOL_MODE=intent \
  -e ACCOUNTTOOL=True \
  -e ACTIVITY_SUBSCRIPTIONSTOOL=True \
  -e AGGREGATETOOL=True \
  -e APPLICATIONTOOL=True \
  -e ATTACHMENTTOOL=True \
  -e AUTHTOOL=True \
  -e BATCHTOOL=True \
  -e CHANGE_MANAGEMENTTOOL=True \
  -e CICDTOOL=True \
  -e CILIFECYCLETOOL=True \
  -e CMDBTOOL=True \
  -e CUSTOM_APITOOL=True \
  -e DATA_CLASSIFICATIONTOOL=True \
  -e DELEGATED_SCOPES=api \
  -e DEVOPSTOOL=True \
  -e EMAILTOOL=True \
  -e FLOWSTOOL=True \
  -e HRTOOL=True \
  -e IMPORT_SETSTOOL=True \
  -e INCIDENTSTOOL=True \
  -e KNOWLEDGE_MANAGEMENTTOOL=True \
  -e METRICBASETOOL=True \
  -e MISCTOOL=True \
  -e OPENAPI_CLIENT_ID=your_openapi_client_id_here \
  -e OPENAPI_CLIENT_SECRET=your_openapi_client_secret_here \
  -e OPENAPI_PASSWORD=your_openapi_password_here \
  -e OPENAPI_USERNAME=your_openapi_username_here \
  -e PLUGINSTOOL=True \
  -e PPMTOOL=True \
  -e PROBLEMTOOL=True \
  -e PRODUCT_INVENTORYTOOL=True \
  -e SDKTOOL=True \
  -e SDK_WORKDIR=/data/servicenow-sdk-workspace \
  -e SERVICENOW_CLIENT_SECRET=your_servicenow_client_secret_here \
  -e SERVICENOW_GRANT_TYPE=password \
  -e SERVICENOW_INSTANCE=https://instance.example.invalid \
  -e SERVICENOW_PASSWORD=your_servicenow_password_here \
  -e SERVICENOW_TLS_PROFILE=system \
  -e SERVICENOW_USERNAME=your_servicenow_username_here \
  -e SERVICE_QUALIFICATIONTOOL=True \
  -e SOURCE_CONTROLTOOL=True \
  -e TABLE_APITOOL=True \
  -e TESTINGTOOL=True \
  -e UPDATE_SETSTOOL=True \
  registry.example.invalid/servicenow-api@sha256:<digest> servicenow-mcp

For containerized network HTTP, supply an authenticated TLS ingress (or
direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy
CIDR policy through the operator-owned deployment profile. The generator
does not emit an unauthenticated non-loopback listener.

Auto-generated from the code-read env surface (MCP_TOOL_MODE + package vars) — do not edit.

Additional Deployment Options

servicenow-api can run as a local stdio process or container, or behind a remote
network boundary. The
Deployment guide carries
the detailed transport contract.

  • Local container — launch a reviewed immutable image as a least-privilege
    stdio child with no listener or published port.
  • Remote URL — connect through an operator-supplied authenticated HTTPS
    ingress. Keep its URL, outbound identity references, trust profile, and exact
    MCP_ALLOWED_HOSTS in AgentConfig.

Agent

This repository features a fully integrated Pydantic AI Graph Agent. It communicates over the Agent Control Protocol (ACP) and interacts smoothly with the Agent Web UI (AG-UI) and Terminal interface.

Running the Agent CLI

To start the interactive command-line agent:```bash

Set credentials

export SERVICENOW_INSTANCE="your_value"
export SERVICENOW_USERNAME="your_value"
export SERVICENOW_CLIENT_ID="your_value"
export SERVICENOW_TLS_PROFILE=system
export DEBUG="your_value"
export PYTHONUNBUFFERED="your_value"
export SERVICENOW_PASSWORD="your_value"
export SERVICENOW_CLIENT_SECRET="your_value"

Run the agent server

servicenow-agent --provider openai --model-id gpt-4o


### Docker Compose Orchestration
The following `docker/agent.compose.yml` configures the Agent, Web UI, and Terminal Interface together:```yaml
version: '3.8'

services:
  servicenow-api-mcp:
    image: example/servicenow-api@sha256:<digest>
    container_name: servicenow-api-mcp
    hostname: servicenow-api-mcp
    restart: always
    env_file:
      - ../.env
    environment:
      - PYTHONUNBUFFERED=1
      - HOST=0.0.0.0
      - PORT=8000
      - TRANSPORT=streamable-http
    ports:
      - "8000:8000"
    healthcheck:

…(正文过长,页面只展示前面部分,完整内容见仓库)

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
servicenow-api 怎么安装?

在客户端按下面的安装命令接入:pip install servicenow-api。对应的包名是 servicenow-api。装完在客户端配置里引用同一个包或端点。

servicenow-api 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

servicenow-api 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

servicenow-api 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

servicenow-api 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

servicenow-api 能提供哪些能力?

资料显示能力标签包括 a2a、a2a-server、ag-ui、mcp、mcp-server。具体工具清单以官方文档为准。

servicenow-api 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

servicenow-api 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-20。