List messages from manitu

What manitu left for this access in the customer panel - unread ones, or all.

RReadIdempotentbetaNeeds account_user

Tool

manitu_access_message_liston https://mcp.manitu.de/mcp

POST

/v1/access/message/liston https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Lists the messages manitu left for the access this connection uses, in the manitu customer panel (notices about services, invoices, security) - only the unread ones unless include_read, without their text: manitu_access_message_get has it. Urgent ones are about something the customer should do soon - mention them. It changes nothing, not even read status.

Arguments

include_readboolean

true: read ones too; left out or false: only the unread ones.

Result structuredContent, checked against the schema

message_listarray of objectrequired

message_list[].message_idintegerrequired

message_list[].statusstringrequired

new: not read yet; read: marked as read (opened in the panel, or set); deleted is never listed.

One of new read deleted

message_list[].prioritystringrequired

urgent: the customer should read it soon - it is about something that needs doing.

One of normal urgent

message_list[].subjectstring | nullrequired

message_list[].created_atstring | nullrequired

Format date-time

message_list[].read_atstring | nullrequired

When it was first read; it stays when set back to new.

Format date-time

count_newintegerrequired

Unread messages.

count_new_urgentintegerrequired

Unread urgent messages.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

include_readboolean

true: read ones too; left out or false: only the unread ones.

Response in `data`; the rest of the body as on every call

message_listarray of objectrequired

message_list[].message_idintegerrequired

message_list[].statusstringrequired

new: not read yet; read: marked as read (opened in the panel, or set); deleted is never listed.

One of new read deleted

message_list[].prioritystringrequired

urgent: the customer should read it soon - it is about something that needs doing.

One of normal urgent

message_list[].subjectstring | nullrequired

message_list[].created_atstring | nullrequired

Format date-time

message_list[].read_atstring | nullrequired

When it was first read; it stays when set back to new.

Format date-time

count_newintegerrequired

Unread messages.

count_new_urgentintegerrequired

Unread urgent messages.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_access_message_list",
    "arguments": {}
  }
}

Result

{
  "structuredContent": {
    "message_list": [
      {
        "message_id": 12345,
        "status": "new",
        "priority": "normal",
        "subject": "string",
        "created_at": "2026-10-23T12:00:00+02:00",
        "read_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_new": 1,
    "count_new_urgent": 1
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/access/message/list

Request

curl -X POST 'https://api.manitu.de/v1/access/message/list' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://api.manitu.de/v1/access/message/list', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/access/message/list');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/access/message/list",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={},
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "message_list": [
      {
        "message_id": 12345,
        "status": "new",
        "priority": "normal",
        "subject": "string",
        "created_at": "2026-10-23T12:00:00+02:00",
        "read_at": "2026-10-23T12:00:00+02:00"
      }
    ],
    "count_new": 1,
    "count_new_urgent": 1
  }
}

List messages from manitu

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call