Propstack MCP by usefulapi

Read Propstack contacts, properties, projects, deals, tasks, events; create and update CRM records.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
85%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~6,801Tokens (Tool-Definitionen)
~3.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (5.31% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "propstack": {
      "url": "https://propstack.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://propstack.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (18)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢propstack_list_contacts(query, email, phone_number, status_ids, source_ids, ...)

List or search CRM contacts (Kontakte). Returns business fields only (name, company, email, phone numbers, status, source, tags, owner, dates), never birth data, identity or tax numbers, income or portal tokens. Search by free text (name, email, address, phone), exact email, exact phone number, or filter by status, source, tag, owner and dates. Archived contacts are excluded unless archived is set. GET /contacts.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over first name, last name, emails, address and phone numbers.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "email": {
      "description": "Exact email address of the contact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 254
    },
    "phone_number": {
      "description": "Exact phone number (spaces and dashes are ignored).",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "status_ids": {
      "description": "Only contacts with one of these contact-status ids.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "source_ids": {
      "description": "Only contacts from one of these source ids (see propstack_get_reference_data contact_sources).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "tag_ids": {
      "description": "Only contacts with these tag (Merkmal) ids (see propstack_get_reference_data contact_tags).",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "broker_id": {
      "description": "Only contacts looked after by this user id (see propstack_list_users).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "archived": {
      "description": "'only' = only archived contacts, 'include' = archived and active. Default: active only.",
      "type": "string",
      "enum": [
        "only",
        "include"
      ]
    },
    "include_children": {
      "description": "Also return sub-contacts (contact persons of a company).",
      "type": "boolean"
    },
    "sort_by": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "last_contact_at",
        "created_at",
        "updated_at",
        "first_name",
        "last_name"
      ]
    },
    "order": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "created_after": {
      "description": "Only contacts created at or after this ISO 8601 date-time.",
      "type": "string"
    },
    "created_before": {
      "description": "Only contacts created at or before this ISO 8601 date-time.",
      "type": "string"
    },
    "updated_after": {
      "description": "Only contacts updated at or after this ISO 8601 date-time.",
      "type": "string"
    },
    "updated_before": {
      "description": "Only contacts updated at or before this ISO 8601 date-time.",
      "type": "string"
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_get_contact(contact_id, custom_fields, include)

One contact by id with address, salutation, language, notes, GDPR status, owner, status, source, tags, sub-contacts and owned properties. Birth data, identity and tax numbers, income and the portal token are never returned. GET /contacts/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack contact id."
    },
    "custom_fields": {
      "description": "Names of custom fields to return (only these; sensitive ones such as birth date or income are never returned).",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "include": {
      "description": "Related records to include: sub-contacts and/or properties the contact owns.",
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "children",
          "owned_properties"
        ]
      }
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_properties(query, status_ids, tag_ids, project_id, marketing_type, ...)

List or search properties (Objekte / units): address, type, marketing type (buy/rent), rooms, areas, prices, status. Images and owners are not returned. Filter by free text, status, tag, project, marketing type, object type, price and area ranges. GET /units.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over unit id, street, zip code, city, district and exposee id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status_ids": {
      "description": "Only properties in one of these status ids (see propstack_get_reference_data property_statuses).",
      "minItems": 1,
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "tag_ids": {
      "description": "Only properties with one of these tag ids (see propstack_get_reference_data property_tags).",
      "minItems": 1,
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "project_id": {
      "description": "Only the units of this project id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "marketing_type": {
      "description": "Sale or rent.",
      "type": "string",
      "enum": [
        "BUY",
        "RENT"
      ]
    },
    "rs_type": {
      "description": "Property type.",
      "type": "string",
      "enum": [
        "APARTMENT",
        "HOUSE",
        "TRADE_SITE",
        "GARAGE",
        "SHORT_TERM_ACCOMODATION",
        "OFFICE",
        "GASTRONOMY",
        "INDUSTRY",
        "STORE",
        "SPECIAL_PURPOSE",
        "INVESTMENT"
      ]
    },
    "country": {
      "description": "Two-letter ISO country code, e.g. DE.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "archived": {
      "description": "'only' = only archived properties, 'include' = archived and active. Default: active only.",
      "type": "string",
      "enum": [
        "only",
        "include"
      ]
    },
    "price_from": {
      "description": "Minimum purchase price.",
      "type": "number",
      "minimum": 0
    },
    "price_to": {
      "description": "Maximum purchase price.",
      "type": "number",
      "minimum": 0
    },
    "base_rent_from": {
      "description": "Minimum cold rent.",
      "type": "number",
      "minimum": 0
    },
    "base_rent_to": {
      "description": "Maximum cold rent.",
      "type": "number",
      "minimum": 0
    },
    "living_space_from": {
      "description": "Minimum living space in square metres.",
      "type": "number",
      "minimum": 0
    },
    "living_space_to": {
      "description": "Maximum living space in square metres.",
      "type": "number",
      "minimum": 0
    },
    "rooms_from": {
      "description": "Minimum number of rooms.",
      "type": "number",
      "minimum": 0
    },
    "rooms_to": {
      "description": "Maximum number of rooms.",
      "type": "number",
      "minimum": 0
    },
    "sort_by": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "created_at",
        "updated_at",
        "price",
        "base_rent",
        "property_space_value",
        "number_of_rooms",
        "construction_year"
      ]
    },
    "order": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_get_property(property_id)

One property (Objekt) by id: address, type, rooms, areas, prices, status and the description, location and furnishing texts (clipped). No images or owner. GET /units/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "property_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack property id."
    }
  },
  "required": [
    "property_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_projects

List projects (Projekte: a project groups several property units): title, project id, status, address, owner. Not paged; at most 200 are returned. GET /projects.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_deals(deal_pipeline_id, deal_stage_ids, category, contact_id, property_id, ...)

List deals (a deal links a contact to a property and sits in a pipeline stage). Filter by pipeline, stage, category (qualified/unqualified/lost), contact, property, project or owner. Use propstack_list_deal_pipelines for stage ids. GET /client_properties.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "deal_pipeline_id": {
      "description": "Only deals in this pipeline.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "deal_stage_ids": {
      "description": "Only deals in these stages.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "category": {
      "description": "Deal category.",
      "type": "string",
      "enum": [
        "qualified",
        "unqualified",
        "lost"
      ]
    },
    "contact_id": {
      "description": "Only the deals of this contact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "property_id": {
      "description": "Only the deals of this property.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "project_id": {
      "description": "Only the deals of this project.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "broker_id": {
      "description": "Only deals owned by this user id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "created_after": {
      "description": "Only deals created at or after this ISO 8601 date-time.",
      "type": "string"
    },
    "created_before": {
      "description": "Only deals created at or before this ISO 8601 date-time.",
      "type": "string"
    },
    "include_contact": {
      "description": "Embed a short contact record in each deal (default false).",
      "type": "boolean"
    },
    "include_property": {
      "description": "Embed a short property record in each deal (default false).",
      "type": "boolean"
    },
    "sort_by": {
      "description": "Sort field (default created_at).",
      "type": "string",
      "pattern": "^[a-z_]{1,40}$"
    },
    "order": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_deal_pipelines

List the deal pipelines with their stages (id, name, position, win chance). Use the stage ids to filter deals or to move a deal. GET /deal_pipelines.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_activities(item_type, contact_id, property_id, project_id, broker_id, ...)

List the activity timeline (notes, tasks, appointments, e-mails, SMS, letters, rejections, inquiries) with title, linked contacts and properties, state and dates. Message and note bodies are not returned. Filter by type, contact, property, project, owner, category or date. GET /activities.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "item_type": {
      "description": "Kind of activity; 'reminder' is a to-do.",
      "type": "string",
      "enum": [
        "message",
        "note",
        "reminder",
        "event",
        "policy",
        "cancelation",
        "decision",
        "sms",
        "letter"
      ]
    },
    "contact_id": {
      "description": "Only activities linked to this contact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "property_id": {
      "description": "Only activities linked to this property.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "project_id": {
      "description": "Only activities linked to this project.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "broker_id": {
      "description": "Only activities assigned to this user id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "category_id": {
      "description": "Only this activity type id (see propstack_get_reference_data activity_types).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "only_inquiries": {
      "description": "Only inquiries (Anfragen).",
      "type": "boolean"
    },
    "starts_after": {
      "description": "Only activities that start at or after this ISO 8601 date-time.",
      "type": "string"
    },
    "starts_before": {
      "description": "Only activities that start at or before this ISO 8601 date-time.",
      "type": "string"
    },
    "created_after": {
      "description": "Only activities created at or after this ISO 8601 date-time.",
      "type": "string"
    },
    "created_before": {
      "description": "Only activities created at or before this ISO 8601 date-time.",
      "type": "string"
    },
    "order": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_get_task(task_id)

One task by id (a note, to-do or appointment): title, body text (clipped), type, linked contacts, properties and projects (id and name only), due date or start/end. GET /tasks/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack task id (the id of a note, to-do or appointment)."
    }
  },
  "required": [
    "task_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_events(starts_after, starts_before, broker_id, contact_id, property_id, ...)

List calendar appointments (Termine, e.g. viewings) in a time window, with title, place, start/end, state and the linked contact, property and project (id and name only). Paged: follow next_page. GET /events.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "starts_after": {
      "description": "Only events that start after this ISO 8601 date-time.",
      "type": "string"
    },
    "starts_before": {
      "description": "Only events that start before this ISO 8601 date-time.",
      "type": "string"
    },
    "broker_id": {
      "description": "Only events assigned to this user id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "contact_id": {
      "description": "Only events with this contact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "property_id": {
      "description": "Only events for this property.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "project_id": {
      "description": "Only events for this project.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "state": {
      "description": "Event state.",
      "type": "string",
      "enum": [
        "neutral",
        "took_place",
        "cancelled"
      ]
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "per": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_list_users

List the users (staff, Nutzer) of the Propstack account: id, name, work email, position, phone, team. Use the ids as owner/broker filters. GET /brokers.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢propstack_get_reference_data(kind)

Look up the ids used by other tools: property_statuses, activity_types (note/task/appointment types, needed as note_type_id), contact_sources, reservation_reasons (rejection reasons), contact_tags or property_tags. GET /property_statuses, /activity_types, /contact_sources, /reservation_reasons or /groups.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "property_statuses",
        "activity_types",
        "contact_sources",
        "reservation_reasons",
        "contact_tags",
        "property_tags"
      ],
      "description": "Which list to fetch."
    }
  },
  "required": [
    "kind"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_create_contact(first_name, last_name, email, salutation, academic_title, ...)

WRITE: create a CRM contact. Propstack matches on the email address: if a contact with the same email already exists it is UPDATED with the given fields instead of creating a duplicate. Consent flags (newsletter, contact permission, GDPR status) cannot be set here. Returns the contact id. POST /contacts.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "description": "First name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "last_name": {
      "description": "Last name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "email": {
      "description": "Primary email address.",
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "salutation": {
      "description": "Salutation: mr or ms.",
      "type": "string",
      "enum": [
        "mr",
        "ms"
      ]
    },
    "academic_title": {
      "description": "Academic title, e.g. Dr.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "company": {
      "description": "Company the contact works for.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "position": {
      "description": "Position in the company.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "is_company": {
      "description": "True if the contact is a company.",
      "type": "boolean"
    },
    "home_cell": {
      "description": "Mobile number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "home_phone": {
      "description": "Landline number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "office_phone": {
      "description": "Business phone number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "office_cell": {
      "description": "Business mobile number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "description": {
      "description": "Internal note on the contact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "language": {
      "description": "Contact language.",
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ]
    },
    "client_status_id": {
      "description": "Contact status id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "client_source_id": {
      "description": "Contact source id (see propstack_get_reference_data contact_sources).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "broker_id": {
      "description": "User id of the person looking after the contact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "custom_fields": {
      "description": "Custom field values by field name; only the given fields change.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_update_contact(contact_id, first_name, last_name, email, salutation, ...)

WRITE: change the given fields of an existing contact; fields not given stay as they are. Returns the updated contact (business fields). PUT /contacts/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack contact id."
    },
    "first_name": {
      "description": "First name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "last_name": {
      "description": "Last name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "email": {
      "description": "Primary email address.",
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "salutation": {
      "description": "Salutation: mr or ms.",
      "type": "string",
      "enum": [
        "mr",
        "ms"
      ]
    },
    "academic_title": {
      "description": "Academic title, e.g. Dr.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "company": {
      "description": "Company the contact works for.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "position": {
      "description": "Position in the company.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "is_company": {
      "description": "True if the contact is a company.",
      "type": "boolean"
    },
    "home_cell": {
      "description": "Mobile number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "home_phone": {
      "description": "Landline number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "office_phone": {
      "description": "Business phone number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "office_cell": {
      "description": "Business mobile number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "description": {
      "description": "Internal note on the contact.",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "language": {
      "description": "Contact language.",
      "type": "string",
      "enum": [
        "de",
        "en",
        "es"
      ]
    },
    "client_status_id": {
      "description": "Contact status id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "client_source_id": {
      "description": "Contact source id (see propstack_get_reference_data contact_sources).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "broker_id": {
      "description": "User id of the person looking after the contact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "custom_fields": {
      "description": "Custom field values by field name; only the given fields change.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_create_task(kind, title, note_type_id, body, contact_ids, ...)

WRITE: create a note, a to-do (with due date) or an appointment (with start and end) in Propstack, linked to contacts, properties or projects. note_type_id is the activity type id (see propstack_get_reference_data activity_types). No e-mail or SMS is sent to the contact; the only mail is the reminder to the assignee when remind_at is set. Returns the new task id. POST /tasks.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "note",
        "todo",
        "appointment"
      ],
      "description": "note = plain note, todo = task with due_date, appointment = event with starts_at and ends_at."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Title."
    },
    "note_type_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Activity type id; must match the kind (see propstack_get_reference_data activity_types)."
    },
    "body": {
      "description": "Note text (plain text; stored as escaped HTML with line breaks).",
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "contact_ids": {
      "description": "Contacts the activity is linked to (usually one).",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "property_ids": {
      "description": "Properties the activity is linked to.",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "project_ids": {
      "description": "Projects the activity is linked to.",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "broker_id": {
      "description": "User id the task is assigned to.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "due_date": {
      "description": "Due date and time (todo only).",
      "type": "string"
    },
    "remind_at": {
      "description": "When Propstack e-mails a reminder to the assignee, before due_date (todo only). This sends a mail to a colleague.",
      "type": "string"
    },
    "starts_at": {
      "description": "Start (appointment only).",
      "type": "string"
    },
    "ends_at": {
      "description": "End (appointment only).",
      "type": "string"
    },
    "location": {
      "description": "Place (appointment only).",
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    }
  },
  "required": [
    "kind",
    "title",
    "note_type_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_update_task(task_id, title, body, broker_id, done, ...)

WRITE: change the given fields of an existing note, to-do or appointment (for example mark a to-do done, move its due date, or reschedule). Fields not given stay as they are. PUT /tasks/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack task id."
    },
    "title": {
      "description": "Title.",
      "type": "string",
      "minLength": 1,
      "maxLength": 250
    },
    "body": {
      "description": "Note text (plain text; stored as escaped HTML with line breaks).",
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "broker_id": {
      "description": "User id the task is assigned to.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "done": {
      "description": "Mark a to-do done (true) or open (false).",
      "type": "boolean"
    },
    "due_date": {
      "description": "New due date and time (to-do).",
      "type": "string"
    },
    "remind_at": {
      "description": "New reminder time (to-do).",
      "type": "string"
    },
    "starts_at": {
      "description": "New start (appointment).",
      "type": "string"
    },
    "ends_at": {
      "description": "New end (appointment).",
      "type": "string"
    },
    "location": {
      "description": "New place (appointment).",
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    }
  },
  "required": [
    "task_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_create_deal(contact_id, property_id, deal_stage_id, broker_id, price, ...)

WRITE: create a deal linking a contact to a property in a pipeline stage (see propstack_list_deal_pipelines for stage ids). Returns the new deal. POST /client_properties.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Contact (prospect) id."
    },
    "property_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Property id."
    },
    "deal_stage_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Pipeline stage id."
    },
    "broker_id": {
      "description": "User id of the deal owner.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "price": {
      "description": "Expected price of the deal.",
      "type": "number",
      "minimum": 0
    },
    "note": {
      "description": "Internal note on the deal.",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    }
  },
  "required": [
    "contact_id",
    "property_id",
    "deal_stage_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴propstack_update_deal(deal_id, deal_stage_id, broker_id, price, note)

WRITE: change the given fields of a deal, typically move it to another pipeline stage or update its note or price. Fields not given stay as they are. PUT /client_properties/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "deal_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Propstack deal id."
    },
    "deal_stage_id": {
      "description": "Move the deal to this stage.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "broker_id": {
      "description": "New deal owner (user id).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "price": {
      "description": "Expected price of the deal.",
      "type": "number",
      "minimum": 0
    },
    "note": {
      "description": "Internal note on the deal (replaces the previous note).",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    }
  },
  "required": [
    "deal_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet18 Tools