Mark a message from manitu read or unread

Sets a message of this access to read, or back to new.

WWriteIdempotentbetaNeeds account_user

Tool

manitu_access_message_seton https://mcp.manitu.de/mcp

POST

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

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Marks a message manitu left for the access this connection uses as read, or as unread again, by its message_id from manitu_access_message_list. Mark it read only when the customer has seen what it says - then the customer panel stops showing it as new. Returns the message as manitu_access_message_get shows it.

Arguments

message_idinteger | stringrequired

The message, from manitu_access_message_list.

pattern ^[1-9][0-9]*$min 1

statusstringrequired

read: the customer has seen it; new: show it as unread again.

One of new read

Result structuredContent, checked against the schema

message_idintegerrequired

statusstringrequired

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

One of new read deleted

prioritystringrequired

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

One of normal urgent

subjectstring | nullrequired

created_atstring | nullrequired

Format date-time

read_atstring | nullrequired

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

Format date-time

bodystring | nullrequired

The text, written by manitu.

Authentication

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

Request body JSON; unknown fields are refused

message_idinteger | stringrequired

The message, from manitu_access_message_list.

pattern ^[1-9][0-9]*$min 1

statusstringrequired

read: the customer has seen it; new: show it as unread again.

One of new read

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

message_idintegerrequired

statusstringrequired

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

One of new read deleted

prioritystringrequired

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

One of normal urgent

subjectstring | nullrequired

created_atstring | nullrequired

Format date-time

read_atstring | nullrequired

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

Format date-time

bodystring | nullrequired

The text, written by manitu.

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_set",
    "arguments": {
      "message_id": 12345,
      "status": "new"
    }
  }
}

Result

{
  "structuredContent": {
    "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",
    "body": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/access/message/set

Request

curl -X POST 'https://api.manitu.de/v1/access/message/set' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "message_id": 12345,
    "status": "new"
  }'

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

<?php

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

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"message_id":12345,"status":"new"}',
    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/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "message_id": 12345,
        "status": "new",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "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",
    "body": "string"
  }
}

Mark a message from manitu read or unread

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