Conecto Forms
Forms and surveys on your own pages, from quote requests to NPS. Pay per action.
我该使用它吗
质量与安全性
发现(2)
- HIGH
- MEDIUM在 forms_create 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"forms": {
"url": "https://api.conecto.chat/mcp/forms"
}
}
}远程端点
https://api.conecto.chat/mcp/formsstreamable-http它能做什么
工具清单
工具(41)
🟡forms_create(title, fields, description, submit_label, thank_you_title, ...)
Create a form or survey with its own public page at https://cncto.co/f/<slug>, which anyone can open and answer; share that link. Field types: short_text, long_text, email, phone (default_country), url, number (min, max, integer), choice and multi_choice (options; multi_choice also min_selections, max_selections), rating (scale 3 to 10, default 5; low_label, high_label), nps (0 to 10; low_label, high_label), date (include_time for a time too, range for a first and a last day, earliest and latest as "2026-11-01" or "today", "today+7", "today-30"; answers read 2026-11-03, 2026-11-03T09:30, 2026-11-03/2026-11-07), yes_no, consent (a checkbox; its label may hold one link written [text](https://...)), statement (text only, no answer). Every field takes type, label, help, required, an id (generated from the label when left out; answers are keyed by it) and show_if {"field": "<an earlier field's id>", "equals": <answer>} to show it only when that answer was given. Each response received costs $0.01, up to 10,000 a month per account. Costs $0.01 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"fields": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9_]{1,40}$",
"description": "Stable id; answers are keyed by it. Generated from the label when left out. Pass it back when you change the form, or a renamed field becomes a new one."
},
"type": {
"type": "string",
"enum": [
"short_text",
"long_text",
"email",
"phone",
"url",
"number",
"choice",
"multi_choice",
"rating",
"nps",
"date",
"yes_no",
"consent",
"statement"
]
},
"label": {
"type": "string",
"maxLength": 1000,
"description": "The question. A statement's label is the text it shows. A consent label may hold one link: \"I agree to the [terms](https://acme.com/terms)\"."
},
"help": {
"type": "string",
"maxLength": 2000,
"description": "Smaller text under the question."
},
"include_time": {
"type": "boolean",
"description": "date: a time too (answers like 2026-11-03T09:30)."
},
"range": {
"type": "boolean",
"description": "date: a first and a last day (2026-11-03/2026-11-07)."
},
"earliest": {
"type": [
"string",
"null"
],
"maxLength": 20,
"description": "date: the first day that can be picked: \"2026-11-01\", \"today\", \"today+1\"."
},
"latest": {
"type": [
"string",
"null"
],
"maxLength": 20,
"description": "date: the last day that can be picked: \"2026-12-31\", \"today+60\", \"today\"."
},
"required": {
"type": "boolean",
"default": false
},
"placeholder": {
"type": "string",
"maxLength": 200,
"description": "short_text, long_text, email, phone, url and number only."
},
"default_country": {
"type": [
"string",
"null"
],
"minLength": 2,
"maxLength": 2,
"description": "phone: the country of numbers typed without a +, like \"US\"."
},
"min": {
"type": [
"number",
"null"
],
"description": "number: the smallest answer."
},
"max": {
"type": [
"number",
"null"
],
"description": "number: the largest answer."
},
"integer": {
"type": "boolean",
"description": "number: whole numbers only."
},
"options": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"description": "choice and multi_choice: [\"Basic\", \"Pro\"], or [{\"id\": \"basic\", \"label\": \"Basic\"}] to keep ids stable when you rename an option.",
"items": {
"type": [
"string",
"object"
]
}
},
"min_selections": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "multi_choice: the fewest options."
},
"max_selections": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "multi_choice: the most options."
},
"scale": {
"type": "integer",
"minimum": 3,
"maximum": 10,
"description": "rating: 3 to 10 (default 5)."
},
"low_label": {
"type": "string",
"maxLength": 60,
"description": "rating and nps: words under the lowest score."
},
"high_label": {
"type": "string",
"maxLength": 60,
"description": "rating and nps: words under the top score."
},
"show_if": {
"type": [
"object",
"null"
],
"required": [
"field",
"equals"
],
"additionalProperties": false,
"description": "Show this field only when an earlier field has this answer (for multi_choice: when that option is among the choices). A hidden field is never required.",
"properties": {
"field": {
"type": "string",
"description": "An earlier field's id."
},
"equals": {
"description": "The answer that shows the field: an option id (choice, multi_choice), true or false (yes_no, consent), a number (number, rating, nps), a date (date) or text (short_text, email)."
}
}
}
}
},
"description": "The questions in order. When changing a form, this replaces the whole list."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Shown under the title."
},
"submit_label": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The button's words (default \"Submit\")."
},
"thank_you_title": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Shown after sending (default \"Thank you\")."
},
"thank_you_message": {
"type": "string",
"maxLength": 1000
},
"redirect_url": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"description": "An https:// page to send people to after they submit. Empty or null: none."
},
"close_at": {
"type": [
"string",
"null"
],
"maxLength": 40,
"description": "Stop taking responses at this time (ISO 8601, like 2026-12-31T23:59:00Z; UTC when no offset is given). Empty or null: never."
},
"max_responses": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 1000000,
"description": "Stop after this many responses. 0 or null: no limit."
},
"notify_email": {
"type": [
"string",
"null"
],
"maxLength": 254,
"description": "Email this address about new responses: at most one email a minute per form, later responses grouped into the next one. Empty or null: off."
},
"confirm_to_respondent": {
"type": "boolean",
"description": "Email each respondent their answers in the brand kit (form_confirmation wording), to the address they typed in the first email field. $0.002 each; paid accounts only; at most three a day to one address."
},
"on_response": {
"type": "array",
"maxItems": 3,
"description": "What each response also does on its own, while you are away ($0.01 per action done): {\"action\": \"open_ticket\", \"priority\": \"normal\"} opens a help desk ticket for the respondent; {\"action\": \"create_deal\", \"pipeline\": \"Sales\", \"stage\": \"New\", \"amount_field\": \"budget\"} creates a deal with them as contact; {\"action\": \"add_row\", \"table\": \"Leads\", \"columns\": {\"Email\": \"email\", \"Budget\": \"budget\"}} adds a row, each column from a field id. [] or null: none.",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"enum": [
"open_ticket",
"create_deal",
"add_row"
]
},
"priority": {
"type": "string",
"enum": [
"low",
"normal",
"high",
"urgent"
]
},
"pipeline": {
"type": "string",
"maxLength": 80
},
"stage": {
"type": "string",
"maxLength": 80
},
"amount_field": {
"type": "string",
"maxLength": 40
},
"table": {
"type": "string",
"maxLength": 80
},
"columns": {
"type": "object"
}
}
}
},
"save_to_crm": {
"type": "boolean",
"description": "Save the person behind each response as a CRM contact. The first email field is the email; a short_text field with id name or full_name (or first_name and last_name) is the name; the first phone field the phone. An existing contact only gets empty fields filled."
},
"hidden_fields": {
"type": "array",
"maxItems": 10,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,40}$"
},
"description": "Link values kept with each response: [\"ref\", \"utm_source\"] keeps them from https://cncto.co/f/<slug>?ref=abc&utm_source=newsletter."
}
},
"required": [
"title",
"fields"
],
"additionalProperties": false
}🔴forms_update(form, title, fields, description, submit_label, ...)
Change a form's fields or settings; only what you pass changes. fields replaces the whole list: pass each existing field's id (forms_get shows them) so its answers stay attached, even when you rename it. Answers to fields or options you remove stay readable in responses, exports and summaries. A field that already has answers keeps its type (short_text and long_text may switch). Empty or null clears redirect_url, close_at and notify_email; max_responses 0 or null removes the limit. Costs $0.01 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"fields": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9_]{1,40}$",
"description": "Stable id; answers are keyed by it. Generated from the label when left out. Pass it back when you change the form, or a renamed field becomes a new one."
},
"type": {
"type": "string",
"enum": [
"short_text",
"long_text",
"email",
"phone",
"url",
"number",
"choice",
"multi_choice",
"rating",
"nps",
"date",
"yes_no",
"consent",
"statement"
]
},
"label": {
"type": "string",
"maxLength": 1000,
"description": "The question. A statement's label is the text it shows. A consent label may hold one link: \"I agree to the [terms](https://acme.com/terms)\"."
},
"help": {
"type": "string",
"maxLength": 2000,
"description": "Smaller text under the question."
},
"include_time": {
"type": "boolean",
"description": "date: a time too (answers like 2026-11-03T09:30)."
},
"range": {
"type": "boolean",
"description": "date: a first and a last day (2026-11-03/2026-11-07)."
},
"earliest": {
"type": [
"string",
"null"
],
"maxLength": 20,
"description": "date: the first day that can be picked: \"2026-11-01\", \"today\", \"today+1\"."
},
"latest": {
"type": [
"string",
"null"
],
"maxLength": 20,
"description": "date: the last day that can be picked: \"2026-12-31\", \"today+60\", \"today\"."
},
"required": {
"type": "boolean",
"default": false
},
"placeholder": {
"type": "string",
"maxLength": 200,
"description": "short_text, long_text, email, phone, url and number only."
},
"default_country": {
"type": [
"string",
"null"
],
"minLength": 2,
"maxLength": 2,
"description": "phone: the country of numbers typed without a +, like \"US\"."
},
"min": {
"type": [
"number",
"null"
],
"description": "number: the smallest answer."
},
"max": {
"type": [
"number",
"null"
],
"description": "number: the largest answer."
},
"integer": {
"type": "boolean",
"description": "number: whole numbers only."
},
"options": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"description": "choice and multi_choice: [\"Basic\", \"Pro\"], or [{\"id\": \"basic\", \"label\": \"Basic\"}] to keep ids stable when you rename an option.",
"items": {
"type": [
"string",
"object"
]
}
},
"min_selections": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "multi_choice: the fewest options."
},
"max_selections": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "multi_choice: the most options."
},
"scale": {
"type": "integer",
"minimum": 3,
"maximum": 10,
"description": "rating: 3 to 10 (default 5)."
},
"low_label": {
"type": "string",
"maxLength": 60,
"description": "rating and nps: words under the lowest score."
},
"high_label": {
"type": "string",
"maxLength": 60,
"description": "rating and nps: words under the top score."
},
"show_if": {
"type": [
"object",
"null"
],
"required": [
"field",
"equals"
],
"additionalProperties": false,
"description": "Show this field only when an earlier field has this answer (for multi_choice: when that option is among the choices). A hidden field is never required.",
"properties": {
"field": {
"type": "string",
"description": "An earlier field's id."
},
"equals": {
"description": "The answer that shows the field: an option id (choice, multi_choice), true or false (yes_no, consent), a number (number, rating, nps), a date (date) or text (short_text, email)."
}
}
}
}
},
"description": "The questions in order. When changing a form, this replaces the whole list."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Shown under the title."
},
"submit_label": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "The button's words (default \"Submit\")."
},
"thank_you_title": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Shown after sending (default \"Thank you\")."
},
"thank_you_message": {
"type": "string",
"maxLength": 1000
},
"redirect_url": {
"type": [
"string",
"null"
],
"maxLength": 2000,
"description": "An https:// page to send people to after they submit. Empty or null: none."
},
"close_at": {
"type": [
"string",
"null"
],
"maxLength": 40,
"description": "Stop taking responses at this time (ISO 8601, like 2026-12-31T23:59:00Z; UTC when no offset is given). Empty or null: never."
},
"max_responses": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 1000000,
"description": "Stop after this many responses. 0 or null: no limit."
},
"notify_email": {
"type": [
"string",
"null"
],
"maxLength": 254,
"description": "Email this address about new responses: at most one email a minute per form, later responses grouped into the next one. Empty or null: off."
},
"confirm_to_respondent": {
"type": "boolean",
"description": "Email each respondent their answers in the brand kit (form_confirmation wording), to the address they typed in the first email field. $0.002 each; paid accounts only; at most three a day to one address."
},
"on_response": {
"type": "array",
"maxItems": 3,
"description": "What each response also does on its own, while you are away ($0.01 per action done): {\"action\": \"open_ticket\", \"priority\": \"normal\"} opens a help desk ticket for the respondent; {\"action\": \"create_deal\", \"pipeline\": \"Sales\", \"stage\": \"New\", \"amount_field\": \"budget\"} creates a deal with them as contact; {\"action\": \"add_row\", \"table\": \"Leads\", \"columns\": {\"Email\": \"email\", \"Budget\": \"budget\"}} adds a row, each column from a field id. [] or null: none.",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"enum": [
"open_ticket",
"create_deal",
"add_row"
]
},
"priority": {
"type": "string",
"enum": [
"low",
"normal",
"high",
"urgent"
]
},
"pipeline": {
"type": "string",
"maxLength": 80
},
"stage": {
"type": "string",
"maxLength": 80
},
"amount_field": {
"type": "string",
"maxLength": 40
},
"table": {
"type": "string",
"maxLength": 80
},
"columns": {
"type": "object"
}
}
}
},
"save_to_crm": {
"type": "boolean",
"description": "Save the person behind each response as a CRM contact. The first email field is the email; a short_text field with id name or full_name (or first_name and last_name) is the name; the first phone field the phone. An existing contact only gets empty fields filled."
},
"hidden_fields": {
"type": "array",
"maxItems": 10,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,40}$"
},
"description": "Link values kept with each response: [\"ref\", \"utm_source\"] keeps them from https://cncto.co/f/<slug>?ref=abc&utm_source=newsletter."
}
},
"required": [
"form"
],
"additionalProperties": false
}🟢forms_get(form)
One form with its fields, settings, public link, whether it is taking responses (and why not), its response count, and this account's monthly allowance of received responses. Free.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
}
},
"required": [
"form"
],
"additionalProperties": false
}🟢forms_list(status, limit)
The account's forms, newest first, with their public links, whether each is taking responses, and their response counts. Free.
输入模式
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"closed",
"any"
],
"default": "any"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50
}
},
"required": [],
"additionalProperties": false
}⚪forms_close(form)
Stop a form taking responses; its page then says it is closed. forms_open reopens it. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
}
},
"required": [
"form"
],
"additionalProperties": false
}⚪forms_open(form)
Let a closed form take responses again. A closing date that has passed is cleared; a form that reached max_responses stays full until you raise it with forms_update. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
}
},
"required": [
"form"
],
"additionalProperties": false
}🔴forms_delete(form)
Delete a form and all its responses for good; its link stops working. Exported files stay in the file store. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
}
},
"required": [
"form"
],
"additionalProperties": false
}🔴forms_delete_response(response_id)
Delete one response for good, for a person who asks to be forgotten or for spam. Exported CSV files keep their copy until you delete them too. Free.
输入模式
{
"type": "object",
"properties": {
"response_id": {
"type": "string",
"minLength": 32,
"maxLength": 36
}
},
"required": [
"response_id"
],
"additionalProperties": false
}🟢forms_list_responses(form, since, limit, cursor)
A form's responses, newest first: for each answer the question, the stored value and a readable answer, plus the link values (hidden_fields) and the CRM contact. When next_cursor is not null, call again with it for older responses. Free.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
},
"since": {
"type": "string",
"maxLength": 40,
"description": "Only responses from this time on: ISO 8601 (2026-10-01T00:00:00Z) or a date (2026-10-01, UTC)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"cursor": {
"type": "string",
"maxLength": 500,
"description": "The next_cursor of the previous page."
}
},
"required": [
"form"
],
"additionalProperties": false
}🟢forms_get_response(response_id)
One response by its response_id, with every answer readable. Free.
输入模式
{
"type": "object",
"properties": {
"response_id": {
"type": "string",
"minLength": 32,
"maxLength": 36
}
},
"required": [
"response_id"
],
"additionalProperties": false
}🟢forms_export_responses(form, since, link_hours)
A CSV file of a form's responses in the file store, with a download link: one row per response, oldest first, one column per field in form order, then the link values. Opens in Excel, Numbers and Google Sheets. With since, only responses from then on. Free when there is nothing to export. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
},
"since": {
"type": "string",
"maxLength": 40,
"description": "Only responses from this time on: ISO 8601 (2026-10-01T00:00:00Z) or a date (2026-10-01, UTC)."
},
"link_hours": {
"type": "integer",
"minimum": 1,
"maximum": 168,
"default": 24,
"description": "How long the download link works, in hours (up to 168, one week)."
}
},
"required": [
"form"
],
"additionalProperties": false
}🟢forms_summary(form, since)
A form's results at a glance: the response count and, per question, choice counts and percentages, rating averages and distributions, the NPS score (percent promoters minus percent detractors), yes and no shares, number minimum, maximum and average, and the 5 latest text answers. With since, only responses from then on. Free.
输入模式
{
"type": "object",
"properties": {
"form": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "The form's form_id or slug (forms_list shows both)."
},
"since": {
"type": "string",
"maxLength": 40,
"description": "Only responses from this time on: ISO 8601 (2026-10-01T00:00:00Z) or a date (2026-10-01, UTC)."
}
},
"required": [
"form"
],
"additionalProperties": false
}🟢account_balance
The account balance, how much of it is credit bought (AI visibility and the phone run only on that) and how much free and bonus credit, what running calls are holding, this key's daily budget, the auto-reload state, and how much of this month's free reads and downloads is used. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢account_get_call(call_id)
One call by id: its status (queued, running, succeeded, failed), cost and result. Use it to poll a background call until it finishes. Free.
输入模式
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 36,
"maxLength": 36
}
},
"required": [
"call_id"
],
"additionalProperties": false
}🟢account_list_calls(status, area, limit)
Recent calls on this account, newest first, optionally only failed or succeeded ones, or one area's. Free.
输入模式
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"reserved",
"running",
"succeeded",
"failed"
]
},
"area": {
"type": "string",
"enum": [
"analytics",
"code",
"crm",
"calendar",
"chat",
"account",
"admin",
"email",
"helpdesk",
"documents",
"esign",
"hiring",
"outreach",
"prospects",
"lookups",
"companies",
"longlists",
"mergers",
"valuation",
"newsletters",
"notify",
"projects",
"schedules",
"speech",
"uptime",
"vault",
"web",
"tables",
"links",
"images",
"files",
"forms",
"helpcenter",
"imports",
"invoices",
"books",
"inventory",
"whistleblowing",
"connect",
"microsoft365",
"googleworkspace",
"hubspot",
"salesforce",
"directory",
"hr",
"social",
"purchasing",
"phone",
"websites",
"views",
"visibility",
"markets"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
}
},
"required": [],
"additionalProperties": false
}🔴account_refund_topup(topup_id)
Refund a top-up paid in the last 24 hours that none of has been used yet: its credit, with the first top-up's bonus, leaves the balance, and the card gets the credit back with its tax. The service fee is kept. Without topup_id, the newest top-up (GET /v1/topups lists them with their ids). Free. Free.
输入模式
{
"type": "object",
"properties": {
"topup_id": {
"type": "integer",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}🟡account_set_owner_email(email)
When the account was made without the owner's email: send that person a link to confirm they own it. Once they confirm, the owner gets the account's warnings and approval requests, and only the owner raises limits. Nothing changes until they open the link. Free. Free.
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"minLength": 3,
"maxLength": 254
}
},
"required": [
"email"
],
"additionalProperties": false
}🟡account_rename(name)
Change the business's name: what Conecto calls the account in its emails, on the owner's page and in the account list, and the sender name on emails and pages to its customers while account_set_brand sets none. Its email addresses and its pages' addresses stay as they are. For the owner's or an admin's assistant and the company-wide team's key without limits. Any other key gets owner_required. Free. Free.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 2,
"maxLength": 120
}
},
"required": [
"name"
],
"additionalProperties": false
}🟢account_owner_link(page)
A link that signs the business owner into their Conecto page, with no password: the balance, adding credit, auto-reload, limits, what the bots did, people, rentals and keys. page opens it where the owner is needed, like people for a role only the owner gives, or settings for joining by email domain. It works once, within 30 minutes; hand it to the owner. Free.
输入模式
{
"type": "object",
"properties": {
"page": {
"type": "string",
"enum": [
"home",
"tools",
"activity",
"apps",
"billing",
"add_credit",
"limits",
"people",
"settings"
],
"default": "home"
}
},
"required": [],
"additionalProperties": false
}🟢account_dashboard_link(area)
A one-time link to a page showing one area as it is when the page opens, for when the person you work for asks to see it themselves: a recruiter looks at the applicants, a bookkeeper at what is due. Do the work and answer with the area's own tools first; a link never replaces that. When an answer would be a long list they would rather look through, offer a link and make it once they say yes. The page is made from the area's own reads as this key, so it shows only what this key may see. It opens once and keeps for an hour; an unopened link ends after 7 days. Free.
输入模式
{
"type": "object",
"properties": {
"area": {
"type": "string",
"enum": [
"analytics",
"code",
"crm",
"calendar",
"chat",
"account",
"admin",
"email",
"helpdesk",
"documents",
"esign",
"hiring",
"outreach",
"prospects",
"lookups",
"companies",
"longlists",
"mergers",
"valuation",
"newsletters",
"notify",
"projects",
"schedules",
"speech",
"uptime",
"vault",
"web",
"tables",
"links",
"images",
"files",
"forms",
"helpcenter",
"imports",
"invoices",
"books",
"inventory",
"whistleblowing",
"connect",
"microsoft365",
"googleworkspace",
"hubspot",
"salesforce",
"directory",
"hr",
"social",
"purchasing",
"phone",
"websites",
"views",
"visibility",
"markets"
]
}
},
"required": [
"area"
],
"additionalProperties": false
}🟢account_get_limits
The limits a business can ask Conecto to raise (calls a minute, new email addresses a day, phone numbers and more): each one's standard and current value and the most that can be asked for, and the business's requests with their answers. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}⚪account_request_limit(limit, amount, reason, other)
Ask Conecto to raise one of the business's limits: which one (or other, saying which), the number it needs, and why, in 40 to 2,000 characters. Conecto reviews it and approves (maybe with less) or declines; the answer comes as the account.limit_request_answered event and by email to the owner, who is also told now. For an account that has topped up; one request per limit at a time, five in 30 days. Free. Free.
输入模式
{
"type": "object",
"properties": {
"limit": {
"type": "string",
"enum": [
"calls_per_minute",
"key_calls_per_minute",
"downloads_per_hour",
"new_email_recipients_per_day",
"documents_emailed_per_day",
"orders_emailed_per_day",
"phone_numbers",
"confirmation_calls_per_day",
"connections",
"storage_blocks",
"prospects_per_month",
"outreach_mailboxes",
"other"
],
"description": "The limit, as account_get_limits names it, or other."
},
"amount": {
"type": "integer",
"minimum": 1,
"maximum": 1000000000,
"description": "The number the business needs, in the limit's unit (5000 calls a minute)."
},
"reason": {
"type": "string",
"minLength": 40,
"maxLength": 2000,
"description": "What the business does that needs it, and why the current limit is too low."
},
"other": {
"type": "string",
"maxLength": 200,
"description": "With limit other: which limit, like \"rows in one table\"."
}
},
"required": [
"limit",
"amount",
"reason"
],
"additionalProperties": false
}🟢account_events(after, kinds, limit)
What happened in this account that someone outside the bot did, oldest first: applications, bookings, form responses, signatures, replies, emails received, goals reached on the website; and the custom events bots sent with account_emit_event. Kept 30 days. Poll with after = the last event_id you saw. Free.
输入模式
{
"type": "object",
"properties": {
"after": {
"type": "integer",
"minimum": 0,
"description": "Only events after this event_id."
},
"kinds": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string"
},
"description": "Event names or areas (\"hiring.*\"); all when left out."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50
}
},
"required": [],
"additionalProperties": false
}🟡account_emit_event(kind, title, text, data, link)
Send an event you name, custom.<name> (custom.lead_qualified, custom.order_shipped), to every channel subscribed to it (notify_subscribe with "custom.*" or its name: Slack, Teams, a webhook to Zapier, Make, n8n or the business's own systems) and to account_events, where another team's bot can pick it up. data is any JSON object (up to 10 KB); sent_by is added with this bot's name and team. $0.005 for each channel it goes to; free when no channel is subscribed. Costs $0.005 per channel it goes to; nothing if none are found.
输入模式
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"minLength": 8,
"maxLength": 66,
"pattern": "^custom\\.[a-z0-9][a-z0-9_.-]*$",
"description": "custom. and a name of lowercase letters, digits, dots, dashes and _."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"text": {
"type": "string",
"maxLength": 4000
},
"data": {
"type": "object"
},
"link": {
"type": "string",
"maxLength": 1000,
"pattern": "^https://"
}
},
"required": [
"kind",
"title"
],
"additionalProperties": false
}🟢account_search(query, areas, limit)
One search over what this account holds: what its files say (PDFs, Word, Excel, PowerPoint, text), table rows, help center articles, CRM contacts, companies and deals, emails, tickets, quotes and invoices, book entries, stock items and project tasks. Every word must appear (any case); titles rank first, then the newest. Each result says which tool opens it. Narrow it with areas. Free.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200
},
"areas": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"enum": [
"files",
"tables",
"helpcenter",
"crm",
"email",
"helpdesk",
"invoices",
"books",
"inventory",
"projects"
]
}
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢account_get_brand
The name, logo, colour and footer line the business's emails and published pages carry. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟡account_set_brand(sender_name, logo_file_id, remove_logo, colour, footer)
The business's name as the sender, its logo (a PNG, JPEG, WebP or GIF from the file store), its colour and a footer line (an address, a legal line), on every email to its customers (bookings, applications, tests, signatures, invoices, newsletters, replies) and on its published pages (forms, booking, careers, newsletters, status, views). Only what you pass changes; an empty string clears it. Mail from Conecto to you keeps Conecto's look. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"sender_name": {
"type": "string",
"maxLength": 120
},
"logo_file_id": {
"type": "string",
"minLength": 36,
"maxLength": 36
},
"remove_logo": {
"type": "boolean",
"default": false
},
"colour": {
"type": "string",
"maxLength": 7,
"description": "Hex, like #1a73e8; empty for none."
},
"footer": {
"type": "string",
"maxLength": 200
}
},
"required": [],
"additionalProperties": false
}🟢account_list_email_templates
Every email Conecto sends to the business's customers (bookings, applications, interviews, tests, signatures, invoices and quotes, newsletter sign-ups), with when it goes out and its subject, headline and opening words as they are now, and the {variables} each can use. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟡account_set_email_template(email, subject, headline, opening)
Change an email's subject, headline or opening words in the business's own voice, with {variables} from account_list_email_templates (like {name} or {when}). The facts under them (times, places, amounts, links and buttons) stay as they are. Only what you pass changes; an empty string brings back the original words. Plain text; a blank line starts a new paragraph. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"maxLength": 40,
"description": "Like booking_booked or invoice_sent."
},
"subject": {
"type": "string",
"maxLength": 200
},
"headline": {
"type": "string",
"maxLength": 120
},
"opening": {
"type": "string",
"maxLength": 4000
}
},
"required": [
"email"
],
"additionalProperties": false
}🟢account_export_all
Everything this account holds, in ZIP files of up to 24 MB saved to its file store: every record of every area as JSON Lines, and the stored files themselves, with a README saying what is where. Credentials are left out. Runs in the background: poll the call with account_get_call; the result has a download link for each part. The parts open only for this key and for the owner's and admins' own keys that neither only read nor only draft. A key of a team other than the company-wide one gets owner_required. Free (EU Data Act). One at a time, three a day; the owner is emailed when an export is made. Free. Runs in the background: the reply has a call_id; poll it with the account_get_call tool or GET /v1/calls/<id>.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢account_audit_log(action, since, limit, verify)
The account's admin and security actions, newest first: keys made and revoked, limits and auto-reload, the owner's sign-ins, connectors, exports, vault reads and writes, credentials set and everything deleted. Ordinary work is in the call log (account_list_calls). verify: true also checks the hash chain, which breaks where an entry was changed or removed. Free.
输入模式
{
"type": "object",
"properties": {
"action": {
"type": "string",
"maxLength": 60,
"description": "Only actions starting with this, like \"key.\" or \"tool.vault_\"."
},
"since": {
"type": "string",
"format": "date-time",
"maxLength": 40
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 50
},
"verify": {
"type": "boolean",
"default": false
}
},
"required": [],
"additionalProperties": false
}🟡account_save_team(name, new_name, areas, read_only, monthly_budget_usd, ...)
A department, location or project group of the account, like Support, Finance or the Hamburg shop. Its keys (POST /v1/keys with "team") can only work in its areas, only read when read_only is on, and spend against its budget (monthly_budget_usd per budget_period: a month, a fiscal quarter or year, or a project total): a hard budget refuses the call that would pass it, a soft one only warns. At alert_percent you get the event account.budget_alert and the owner an email, once a period. erp_code is the team's cost center in the company's ERP, for statements. drafts_only makes every write of its keys wait for one of its managers (or the owner), for a new bot that should only draft. mailboxes are the Microsoft 365 or Google mailboxes its keys may act as. You may make a team and narrow one; widening its areas, letting it write, ending drafts only, switching a hard budget to soft, and raising or removing a budget are the owner's, on their account page, when the account has an owner email. The company-wide team holds every key no other team does and is never limited to areas. $0.001. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"new_name": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Renames the team; its keys, spend and budget stay with it."
},
"areas": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"maxItems": 50,
"description": "The areas its keys may work in (account tools always); null for every area."
},
"read_only": {
"type": "boolean",
"description": "Its keys only read, and get links that act for whoever opens them as \"[redacted]\"."
},
"monthly_budget_usd": {
"type": [
"number",
"null"
],
"minimum": 0,
"maximum": 1000000,
"description": "null counts the spend without a cap."
},
"budget": {
"type": "string",
"enum": [
"hard",
"soft"
],
"description": "hard refuses calls past the budget; soft only warns."
},
"alert_percent": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"erp_code": {
"type": [
"string",
"null"
],
"maxLength": 40
},
"drafts_only": {
"type": "boolean",
"description": "Every write of its keys waits for a person, and they get links that act for whoever opens them as \"[redacted]\"."
},
"mailboxes": {
"type": [
"array",
"null"
],
"maxItems": 20,
"items": {
"type": "string",
"maxLength": 254
},
"description": "The Microsoft 365 or Google mailboxes its keys may act as; null for every mailbox the connection lists."
},
"budget_period": {
"type": "string",
"enum": [
"month",
"quarter",
"year",
"project"
],
"description": "What the budget is for: a month, a quarter or a year of the account's fiscal calendar, or a project total until budget_ends_on."
},
"budget_ends_on": {
"type": [
"string",
"null"
],
"format": "date",
"description": "The last day of a project budget, like 2026-12-31."
},
"sees_sensitive": {
"type": "boolean",
"description": "false hides suppliers' bank details and HR notes and contracts from its keys; only the owner turns it on."
}
},
"required": [
"name"
],
"additionalProperties": false
}🟢account_list_teams
The account's teams, the company-wide one first: each with its areas, whether it only reads, its budget (hard or soft, and its period) and alert line, this period's spend, its ERP code, whether it is paused, its keys, and its people with who manages it. A person's own assistant works within their teams. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}⚪account_pause_team(team)
Stops every key of a team at once, this one too if it is the team's: their calls are refused until the owner starts the team again on their account page. For a bot that misbehaves or a team that spends too fast. Free. Free.
输入模式
{
"type": "object",
"properties": {
"team": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"team"
],
"additionalProperties": false
}⚪account_assign_team(kind, id, team)
Move a form, a meeting type, a job, an inbox, a phone number, a newsletter, the website chat, a rental, a pipeline, a table or a website to a team. What happens through it is charged to that team from now on (a form's responses, a number's calls, an inbox's tickets), and its rental moves with it. Something a bot makes already belongs to the bot's team. Only a key of the company-wide team without limits moves things between teams. $0.001. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"form",
"meeting_type",
"job",
"inbox",
"phone_number",
"newsletter",
"chat",
"rental",
"pipeline",
"table",
"website"
]
},
"id": {
"type": "string",
"maxLength": 254,
"description": "Its id, slug, name, address or number; not needed for the chat."
},
"team": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"kind",
"team"
],
"additionalProperties": false
}🟡account_add_approval_rule(tool, argument, over, values, approver_email, ...)
Make a tool wait for a person: every call of it, those whose argument is over a number (like invoices_create_credit_note when amount is over 500), or those whose argument is one of some values (like connect_call when method is POST, PUT, PATCH or DELETE). A held call answers approval_required with an approval_id and asks the approver; when they approve, call again with the same arguments, once (a call no person answers for adds the approval: header X-Conecto-Approval, or _meta.approvalId over MCP). The approver is an email, a saved channel, or a team (its managers, or everyone in it); each approver gets a link of their own, and the person whose call it is never approves it. With two_people_over, calls whose argument is over it need two people. Bills like Xero's bill approval: purchasing_create_bill with argument total holds bills over an amount, tax included; a rule on purchasing_pay_bill also holds batches with such a payment. Removing a rule is the owner's, on their account page, when the account has an owner email. $0.001. Costs $0.001 per call; nothing if it fails.
输入模式
{
"type": "object",
"properties": {
"tool": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"argument": {
"type": "string",
"maxLength": 60,
"description": "An argument of the tool (or total, for purchasing_create_bill)."
},
"over": {
"type": "number",
"description": "Calls with argument over this are held."
},
"values": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"description": "Calls with argument equal to one of these (any case) are held."
},
"approver_email": {
"type": "string",
"maxLength": 254
},
"approver_channel": {
"type": "string",
"maxLength": 80,
"description": "A saved notify channel."
},
"approver_team": {
"type": "string",
"maxLength": 80,
"description": "A team (account_list_teams)."
},
"approvers": {
"type": "string",
"enum": [
"managers",
"everyone"
],
"default": "managers",
"description": "Who in approver_team approves."
},
"two_people_over": {
"type": "number",
"description": "Calls whose argument is over this need two people; higher than over."
}
},
"required": [
"tool"
],
"additionalProperties": false
}🟢account_list_approval_rules
The tools that wait for a person's approval, with their thresholds and approvers. Free.
输入模式
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢account_find_person(email, phone)
Every record this account holds about one person, by their email address or phone number, across every area: CRM, chats, emails, tickets, forms, bookings, calls, applications, invoices, orders, newsletters, HR and the call log, with their chats and CRM history. For a person who asks what the business keeps about them (GDPR Art. 15). Shows each kind with its count and ids; account_export_person gives them a copy, account_erase_person erases what may go. Free.
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"maxLength": 254,
"description": "The person's email address."
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "Their phone number in international format, like +1 503 555 0145."
}
},
"required": [],
"additionalProperties": false
}🟢account_export_person(email, phone)
Everything account_find_person finds about one person in one ZIP in the file store: their records as JSON Lines (credentials left out) and the files those records point to, like a CV. Give the person the download link when they ask for a copy of their data (GDPR Art. 15 and 20), once you know it is them. The ZIP opens only for this key and for the owner's and admins' own keys that neither only read nor only draft. A key of a team other than the company-wide one gets owner_required: pass the request to the owner. Free; 20 a day. Free.
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"maxLength": 254,
"description": "The person's email address."
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "Their phone number in international format, like +1 503 555 0145."
}
},
"required": [],
"additionalProperties": false
}🔴account_erase_person(email, phone, correspondence)
Erases one person across every area when they ask (GDPR Art. 17), once you know it is them (they wrote from that address, or confirmed it). Their CRM contact, chat visitor, past meetings and calls are anonymised, so deals stay without them, and a meeting they were only a guest at drops them; their chats, CRM history, form and routing form answers, job applications with the CV, newsletter subscriptions and events are deleted, and the call log's contents that name them are cleared. Kept, each with its reason in the result: accounting records, employment records, signed documents, the audit log, the account's own settings, upcoming meetings, and emails and tickets (outreach emails and replies too) unless correspondence is true. Their address goes on the suppression lists, so it is never mailed again: outreach campaigns stop for them at once. Can't be undone; the owner is emailed. A key of a team other than the company-wide one gets owner_required: pass the request to the owner. Free. Free.
输入模式
{
"type": "object",
"properties": {
"email": {
"type": "string",
"maxLength": 254,
"description": "The person's email address."
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "Their phone number in international format, like +1 503 555 0145."
},
"correspondence": {
"type": "boolean",
"default": false,
"description": "Also delete their emails and tickets, when no law requires keeping them."
}
},
"required": [],
"additionalProperties": false
}🟢account_data_locations(areas)
Where each area's data is stored and processed: the company that runs each place, the country or region, and what it holds. Every area keeps its records in the database and runs on Conecto's servers; some also use a service named here (email, phone, PDFs, search). For the business's records of processing and its transfer assessments (GDPR Art. 30 and 44). Free.
输入模式
{
"type": "object",
"properties": {
"areas": {
"type": "array",
"maxItems": 50,
"items": {
"type": "string",
"maxLength": 40
},
"description": "Areas to show, like [\"email\", \"phone\"]; all when left out."
}
},
"required": [],
"additionalProperties": false
}社区
证据