Contacts

Use these tools to work with the people stored in a KlickTipp account. They support the contact lifecycle, from finding and creating contacts to updating their information and managing their subscription state.

For example, you can search for contacts, update their field values, subscribe them through an opt-in process, or unsubscribe them when required. Further contact-related actions may be added as the MCP server develops.

MCP tools

Get Contact

Tool name: get-contact

Returns the permitted detail view of one contact in a KlickTipp account: email address and email subscription status, mobile number and SMS subscription status, contact fields for the requested reference, writable manual tag IDs and the edit link. A contact reachable on only one of the two channels is answered with the other one empty, and is found either way. Every field carries its data type, and the three that are stored as numbers are answered exactly as KlickTipp shows them on screen: a date as 16.09.2026, a moment as 16.09.2026 14:30, a time of day as 14:30, in the time zone the account is configured for. It does not expose complete channel or subscription-reference records.

Input schema

contactIdinteger, >= 1required

Numeric contact ID returned by search-contacts

referenceIdinteger, >= 0

Reference whose multi-value fields and manual tags to read; 0 for contact-wide values

Default:0

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null

Input example

{
  "contactId": 1,
  "referenceId": 0,
  "accountId": null
}

Output schema

accountIdintegerrequired

contactIdintegerrequired

emailstringrequired

subscriptionStatusstringrequired

phoneNumberstringrequired

smsSubscriptionStatusstringrequired

referenceIdintegerrequired

fieldsArray of objectsrequired

manualTagIdsArray of integersrequired

editUrlstringrequired

Output example

{
  "accountId": 0,
  "contactId": 0,
  "email": "string",
  "subscriptionStatus": "string",
  "phoneNumber": "string",
  "smsSubscriptionStatus": "string",
  "referenceId": 0,
  "fields": [
    {
      "fieldId": "string",
      "value": "string",
      "type": "string",
      "referenceId": 0
    }
  ],
  "manualTagIds": [
    0
  ],
  "editUrl": "string"
}