Cirqll MCP by usefulapi
Read customers, contacts, tasks and sales chances; create customers, tasks and notes in Cirqll.
Should I use this
Quality & Safety
Findings (1)
- LOWin cirqll_create_note
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"cirqll": {
"url": "https://cirqll.usefulapi.io/mcp"
}
}
}Remote endpoints
https://cirqll.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢cirqll_get_me
Return the Cirqll user the access token belongs to, with roles and permissions. Use it to confirm the account. Cirqll API: GET /auth/me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_customers(limit, offset, filter, order_by, with, ...)
List customers in the CRM, with paging, filter and sort. Use it for customer overviews and search. Cirqll API: GET /customer.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_get_customer(customer_id, with, show)
Get one customer by id, with its custom field values and any related data you ask for in with. Cirqll API: GET /customer/{id}.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric Cirqll id."
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_contacts(limit, offset, filter, order_by, with, ...)
List contacts (people at customers). Filter by customer with filter="customer_id:eq:<id>". Cirqll API: GET /contact.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_tasks(limit, offset, filter, order_by, with, ...)
List tasks, optionally filtered by date, assignee or customer. Cirqll API: GET /task.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_appointments(limit, offset, filter, order_by, with, ...)
List appointments for calendar and overview use, filter by date range, user or customer. Cirqll API: GET /appointment.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_chances(limit, offset, filter, order_by, with, ...)
List sales opportunities (chances) in the pipeline, filter by stage, value or customer. Cirqll API: GET /chance.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cirqll_list_notes(limit, offset, filter, order_by, with, ...)
List notes attached to customers. Filter by customer with filter="customer_id:eq:<id>". Cirqll API: GET /note.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Items to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Cirqll filter, field:operator:value, e.g. name:eq:\"Acme\". Group with (a:op:v,and,b:op:v).",
"type": "string"
},
"order_by": {
"description": "Sort as field:direction, comma separated, e.g. name:asc or created_at:desc,name:asc. A field without a direction sorts ascending.",
"type": "string",
"maxLength": 200
},
"with": {
"description": "Related data to include, comma separated, e.g. contacts,notes. Cirqll advises not to combine it with show.",
"type": "string"
},
"show": {
"description": "Only these fields, comma separated, e.g. name,email (id is always included). Cirqll advises not to combine it with with.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cirqll_create_customer(name, description, email, phone)
Create a new customer record in the CRM. Only the fields you pass are set. Cirqll API: POST /customer.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Customer name."
},
"description": {
"description": "Free-text description.",
"type": "string",
"maxLength": 65535
},
"email": {
"description": "Customer email address.",
"type": "string",
"maxLength": 255,
"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,}$"
},
"phone": {
"description": "Customer phone number.",
"type": "string",
"maxLength": 255
}
},
"required": [
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cirqll_create_task(customer_id, name, date, description)
Create a task linked to a customer, with a due date. Cirqll API: POST /task.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric Cirqll id."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Task title."
},
"date": {
"type": "string",
"description": "Due date and time, ISO 8601 UTC."
},
"description": {
"description": "Task details.",
"type": "string",
"maxLength": 65535
}
},
"required": [
"customer_id",
"name",
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cirqll_create_note(customer_id, date, description)
Attach a note to a customer, with a date. Cirqll API: POST /note.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "Numeric Cirqll id."
},
"date": {
"type": "string",
"description": "Note date and time, ISO 8601 UTC."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Note text, up to 255 characters."
}
},
"required": [
"customer_id",
"date",
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence