Matrix42 MCP Server

A Model Context Protocol server that lets an assistant explore a Matrix42 instance the way an experienced consultant would: find the right web service, read the real data model, query records with…

Local serverstdioMIT

What is the Matrix42 MCP Server?

matrix42-mcp is an MCP project maintained in the sus-tech-gmbh/matrix42-mcp repository. The maintainer describes its purpose as “A Model Context Protocol server that lets an assistant explore a Matrix42 instance the way an experienced consultant would: find the right web service, read…”. Read the project documentation for the complete scope.

Installation

The documented npm package is matrix42-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares M42_HOST, M42_API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
server_infoReports which Matrix42 instance is connected and verifies the credentials work. Never returns credentials.
webservice_discoveryDiscovers the REST API. See the actions below.
schema_discoveryExplores the data model: data definitions, configuration items, attributes, relations, pickup values.
data_queryReads records: ASQL queries, saved views, journal entries, attachments, plus an ASQL guide and validator.
service_deskSearches tickets of any kind, answers service-level questions, and browses assets, contracts, catalog services, bookings, knowledge articles, approvals…
ticket_actionsWrites - the ticket lifecycle: create, close, take over, forward, pause, reopen, set deadlines, track time, add journal entries. Only present when…
ActionNotes
api_overview-
list_operationssearch?, service_id?, limit?
list_services-
describe_operationoperation_id
schema_overview-
list_data_definitionssearch?, include_pickups?, limit?
list_configuration_itemssearch?, limit?
describe_data_definitionname, include?
describe_configuration_itemname
get_pickup_valuespickup_class or name+attribute
asql_guide-
validate_asqlclass, expression
queryclass, columns?, where?, sort?, page_size?, page?
get_fragmentclass, fragment_id
get_objectci_name, object_id
list_journalobject_id
list_attachmentsobject_id
deep_linkobject_id, view_type?
data_model-
search_ticketskind, plus subject, category_name and/or states
get_ticketticket_object_id
sla_for_ticketticket_object_id
sla_timesticket_object_id
browsedomain, search?, where?, limit?
findsearch, domains?, limit?
create_ticketReturns the new object id, which every other action takes directly.
close_ticketCloses by object id, with an optional solution and closing reason.
add_journal_entryAdds a comment to any object, with optional template parameters.
classify_ticketOnly suggests a type from text - changes nothing.
forwardHands tickets to a role_id or user_id, optionally applying an OLA.
pauseHolds a ticket, optionally stopping the escalation clock (not_escalate_while_paused).
reopenReverses a close, with a reason.
return_to_roleGives one ticket back to its responsible role.
set_deadlineSets the date the ticket must be handled by.
track_working_timeBooks effort, optionally typed (investigation, resolution, …).
transformTurns tickets into another type - an incident into a service request, say. Rewrites what the record is; fields the target type lacks are lost.
PromptFor
explore_instanceGetting oriented in an unfamiliar instance
build_queryTurning a question into a validated ASQL query
triage_ticketWorking one ticket end to end, without changing anything
safe_changeWalking a write through preview → confirm
find_endpointLocating the right operation before writing integration code
URIContents

How to install the Matrix42 MCP Server

{
  "mcpServers": {
    "matrix42": {
      "command": "npx",
      "args": [
        "-y",
        "matrix42-mcp"
      ],
      "env": {
        "M42_HOST": "https://matrix42.example.com",
        "M42_API_TOKEN": "YOUR_M42_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
M42_HOSTDeclared in the maintainer’s client configuration.Check documentation
M42_API_TOKENDeclared in the maintainer’s client configuration.Check documentation