Cirqll MCP by usefulapi

Read customers, contacts, tasks and sales chances; create customers, tasks and notes in Cirqll.

Should I use this

Quality & Safety

A
Description quality
97%
Schema completeness
88%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'cirqll_create_note' description lacks action verbin cirqll_create_note

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,628Tokens (tool definitions)
~2.0 KBTypical response size
Significant attention impact (2.05% of 128k context)

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-http

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools