cherwell-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CHERWELL_BASE_URL | Yes | CSM host root, e.g. https://csm.example.com | |
| CHERWELL_PASSWORD | Yes | Cherwell user password | |
| CHERWELL_USERNAME | Yes | Cherwell user login | |
| CHERWELL_AUTH_MODE | No | Authentication mode: internal (default), windows, ldap, or saml | internal |
| CHERWELL_CLIENT_ID | Yes | REST API client key | |
| CHERWELL_TIMEOUT_MS | No | Per-request timeout in milliseconds, default 30000 | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_business_object_summariesA | List Cherwell business objects (names and busObIds). Use this to discover which objects exist and to find the busObId or exact name needed by the other tools. |
| get_business_object_templateA | Get the field schema (template) of a business object: field IDs, names, display names and required flags. Use this to learn which fields exist before creating, updating or searching records. |
| get_business_objectA | Read a single business object record with all its field values, addressed by record ID (busObRecId) or public ID (e.g. incident number). Provide exactly one of recId / publicId. |
| create_business_objectA | Create a new business object record. Pass field values as a map of field name (or display name) to value. Use get_business_object_template with requiredOnly=true to see which fields are mandatory. Returns the new record's busObRecId and public ID. |
| update_business_objectB | Update fields of an existing business object record, addressed by record ID (busObRecId) or public ID. Only the provided fields are changed. Provide exactly one of recId / publicId. |
| delete_business_objectA | Permanently delete a business object record by its record ID (busObRecId). This cannot be undone. |
| search_business_objectsA | Search business object records with field filters. Filters on the SAME field are OR-ed together; filters on DIFFERENT fields are AND-ed (Cherwell semantics). Supports paging and an optional list of fields to return (defaults to all fields). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a clearly distinct action: listing object types, reading one record, creating, deleting, getting schema, updating, and searching. The descriptions explicitly clarify boundaries, such as get_business_object_template for schema versus get_business_object for record data. No two tools appear interchangeable.
All tool names use snake_case and a consistent verb_noun pattern: list_, get_, create_, delete_, update_, search_. The minor extra suffixes (summaries, template) still follow the same predictable style.
Seven tools is well-scoped for a Cherwell business-object CRUD surface. Each tool covers a necessary operation without redundancy or bloat.
The set provides full lifecycle coverage for business object records: discovery, schema inspection, create, read, update, delete, and search. No obvious operational gap exists for the stated domain.