Senta MCP by usefulapi
Review Senta clients, contacts and jobs, and update client records or add notes.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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": {
"senta": {
"url": "https://senta.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://senta.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (7)
🟢senta_search_clients(keywords, limit)
Find the practice's clients by keywords. Returns matching clients with their id (`_id`) and name (`title`). Use the id with senta_get_client, senta_list_jobs or senta_add_note. GET /api/clients/search.
Eingabe-Schema
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Words to match client names against."
},
"limit": {
"description": "Most records to return (default 100, max 1000). Senta has no paging, so this only cuts the reply.",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"keywords"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢senta_get_client(client_id)
Read one client: name, state, type, business area, contacts (name, email, mobile, shareholding), address and the other fields the practice configured. GET /api/clients/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The client id (`_id`), e.g. c260af21ede8f, from senta_search_clients."
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢senta_list_client_view(view_id, limit)
Read a saved client list of the practice (the same filter and columns as in the Senta app). The view id is the last part of the list's address: https://<practice>.senta.co/c/l/v08a361263f4a has the view id v08a361263f4a. Column names are the list's column titles (for example "Client name", "State"). GET /api/clients/{viewId}.
Eingabe-Schema
{
"type": "object",
"properties": {
"view_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The client list (view) id, e.g. v08a361263f4a."
},
"limit": {
"description": "Most records to return (default 100, max 1000). Senta has no paging, so this only cuts the reply.",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"view_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢senta_list_jobs(client_id, template_id, status, limit)
List jobs (id, client id `cid`, job template id `wid`, title and main date). Filter by client, job template or status (pending, ready, overdue, completed, cancelled). With no filter this is every job of the practice, so filter when you can. GET /api/jobs.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Only jobs of this client (`cid`)."
},
"template_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Only jobs made from this job template (`wid`)."
},
"status": {
"description": "Only jobs with this status.",
"type": "string",
"enum": [
"pending",
"ready",
"overdue",
"completed",
"cancelled"
]
},
"limit": {
"description": "Most records to return (default 100, max 1000). Senta has no paging, so this only cuts the reply.",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡senta_create_client(title, clientstate, clienttype, businessarea, paymentmethod, ...)
WRITE: create a new client (company) in the practice. A name (title) is required; the other fields depend on the practice's own client form. Returns the new client with its id. Check senta_search_clients first so you do not create a duplicate. POST /api/clients.
Eingabe-Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Client name (Senta's `title`)."
},
"clientstate": {
"description": "State, e.g. \"Prospect\" or \"Client\" (the practice's own states).",
"type": "string",
"maxLength": 100
},
"clienttype": {
"description": "Type, e.g. \"Partnership\".",
"type": "string",
"maxLength": 100
},
"businessarea": {
"description": "Business area, e.g. \"Veterinary\".",
"type": "string",
"maxLength": 200
},
"paymentmethod": {
"description": "Payment method, e.g. \"Monthly\".",
"type": "string",
"maxLength": 100
},
"vatservice": {
"description": "Whether the VAT service applies.",
"type": "boolean"
},
"telephone": {
"type": "string",
"maxLength": 60
},
"web": {
"type": "string",
"maxLength": 300
},
"twitter": {
"type": "string",
"maxLength": 100
},
"address1": {
"type": "string",
"maxLength": 300
},
"address2": {
"type": "string",
"maxLength": 300
},
"district": {
"type": "string",
"maxLength": 200
},
"town": {
"type": "string",
"maxLength": 200
},
"postcode": {
"type": "string",
"maxLength": 30
},
"extra_fields": {
"description": "Other fields configured by the practice (Settings > Forms > Edit Client), keyed by Senta's internal field name.",
"type": "object",
"propertyNames": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,99}$"
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"contacts": {
"description": "Contacts: firstname, lastname, email, mobile, shareholding.",
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"firstname": {
"type": "string",
"maxLength": 200
},
"lastname": {
"type": "string",
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 254
},
"mobile": {
"type": "string",
"maxLength": 60
},
"shareholding": {
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
}
}
},
"required": [
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴senta_update_client(client_id, title, clientstate, clienttype, businessarea, ...)
WRITE: partially update an existing client; only submitted properties are changed, per Senta's Client API. Read current contacts with senta_get_client before editing them and pass the contact details to update or add. Changing clientstate or enabling a service can start jobs in Senta. There is no delete tool. PUT /api/clients/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The client id (`_id`) to update."
},
"title": {
"description": "Client name (Senta's `title`).",
"type": "string",
"minLength": 1,
"maxLength": 300
},
"clientstate": {
"description": "State, e.g. \"Prospect\" or \"Client\" (the practice's own states).",
"type": "string",
"maxLength": 100
},
"clienttype": {
"description": "Type, e.g. \"Partnership\".",
"type": "string",
"maxLength": 100
},
"businessarea": {
"description": "Business area, e.g. \"Veterinary\".",
"type": "string",
"maxLength": 200
},
"paymentmethod": {
"description": "Payment method, e.g. \"Monthly\".",
"type": "string",
"maxLength": 100
},
"vatservice": {
"description": "Whether the VAT service applies.",
"type": "boolean"
},
"telephone": {
"type": "string",
"maxLength": 60
},
"web": {
"type": "string",
"maxLength": 300
},
"twitter": {
"type": "string",
"maxLength": 100
},
"address1": {
"type": "string",
"maxLength": 300
},
"address2": {
"type": "string",
"maxLength": 300
},
"district": {
"type": "string",
"maxLength": 200
},
"town": {
"type": "string",
"maxLength": 200
},
"postcode": {
"type": "string",
"maxLength": 30
},
"extra_fields": {
"description": "Other fields configured by the practice (Settings > Forms > Edit Client), keyed by Senta's internal field name.",
"type": "object",
"propertyNames": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,99}$"
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 5000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"contacts": {
"description": "Contact details to update or add, following the practice's contact form. Read current contacts before editing.",
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"firstname": {
"type": "string",
"maxLength": 200
},
"lastname": {
"type": "string",
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 254
},
"mobile": {
"type": "string",
"maxLength": 60
},
"shareholding": {
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
}
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡senta_add_note(client_id, text, job_id, note_type, date)
WRITE: add a note to a client, optionally attached to one of its jobs. The text may contain simple HTML. Returns the note. POST /api/notes.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The client id (`cid`) the note belongs to."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 50000,
"description": "The note text (simple HTML allowed)."
},
"job_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Optional job id (`jid`) to attach the note to."
},
"note_type": {
"description": "Note type, e.g. \"Phone call\" (default \"Note\").",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"date": {
"description": "When the note refers to, ISO 8601 (default: now).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2})?)?$"
}
},
"required": [
"client_id",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis