Server definition
- Hash
- sha256:dba86766867c3a9792e6aa5cec9d52c50cc3ffc54bae7ac3f5fb4d8bed10883a
- What it is
- What a remote MCP server returned when asked what it offers: 48 tools
The blob, as servednamed by its sha256
{
"instructions": "TaskLite is the backend: data lives in boards (tables) inside projects\n(one project = one business process). The boards are also the ready-made\nadmin the end client operates, so you are building a real system.\n\nConnect first: call connection_status. If not connected, this is a new user:\nask for email, name, and a business name, then call sign_up (creates account +\norg from here; a password is set locally and never shown). (sign_up exists only\non the local install; hosted connections authenticate via OAuth.)\n\nFinding your way around an existing account: list_projects then list_boards. Changing a model after the fact: update_column (name, type, options), delete_column, reorder_columns, update_board, delete_board, no need to rebuild. create_item saves the title and all cells in one call. Column rules (settings.validation: unique, min/max, pattern) and closed-choice options are enforced on every write, so a 400 names the column and the rule. Automations can pause with a delay action and retry network actions (config.retry). export_project returns the project as JSON. To find something by text across the whole organization: search, then fetch the id it returns.\nBoth page at 50, so read the total before concluding something is missing.\n\nBuild order: create_project -> create_board -> create_column per field, then\nget_board_schema to read the real column ids before adding data with create_item\n(cells are keyed by those ids). Pick honest types: a status field is a dropdown\nwith real options, not free text.\n\nColumn types carry the whole UX, so choose by meaning and never default to text:\ndate/datetime for dates and deadlines (unlocks calendar and timeline views),\nphone for phone numbers (tap-to-call), email for emails, number or currency for\nquantities/prices/amounts, rating for scores, dropdown or status WITH\nsettings.options for any closed choice, file for uploads. A date stored as text\ncan never power a calendar, a reminder, or an overdue filter. Long free text or\nnotes are the only good use of text/rich_text. create_column rejects an obvious\nmismatch (e.g. an \"Install Date\" column typed text) with the suggested type;\nretry with that type, or pass force:true if the name is misleading.\n\nInfer a sound schema from the domain instead of asking the user to design tables:\norders/service -> an Orders board (customer, phone, item, status select, price,\ndue date); CRM -> Contacts + Deals (stage select, value, contact link); bookings\n-> one date-keyed board with a status select; inventory -> items (name, sku,\nquantity, category select). Prefer few well-typed boards over many thin ones.\n\nWhen a board needs a number from outside (a price, an exchange rate, a shipment\nstatus, weather) use create_automation with the http_request action:\nit calls the API and writes the answer straight into columns via\nresponseMapping [{ path, columnId }] (ids from get_board_schema). With the\n\"scheduled\" trigger the board refreshes itself, so do not tell the user they\nneed Make or n8n for this. https only; internal hosts are refused.\n\nOnly if the user wants an external frontend/app: create_app (needs projectId) ->\ncreate_app_endpoint (choose exposedColumns; enable rowLevelSecurity whenever\nthe app has its own users) -> publish_app -> create_app_api_key, then\nget_frontend_prompt(tool: \"claude-code\"). The app API key (tk_...) is\nserver-side only: keep it in an env var and call the app API from server code,\nnever the browser. exposedColumns is effectively required: an endpoint without\nit answers reads with bare item metadata and refuses writes. The app API is\nserved ONLY from api.tasklite.net; app.tasklite.net is the admin UI and\nanswers unknown paths with a page, so use the absolute baseUrl from\nget_app_spec verbatim. Full reference, including how to read each failure:\nhttps://tasklite.net/docs Users are the developer's own (any sign-in); their server\nsends X-App-User: <user id> with the key, and endpoints with rowLevelSecurity\nreturn, update and delete only that user's rows. No user system to build.\n\nTaskLite also HOSTS static frontends. deploy_frontend takes the site in one\nof three ways: files (inline path+content, from ChatGPT or any hosted client,\nwrite index.html and its assets and deploy in the same turn), zipUrl (a public\nhttps zip such as a Lovable/Bolt export or a GitHub release asset), or dir (a\nlocal build folder, only when the MCP runs next to the files). The result is a\nlive https://{slug}.tasklite.dev URL, no server or hosting setup on the user's\nside. Hosted frontends call the app API at the relative path /api/{endpoint}\n(the hosting proxy injects the app identity), so generated code needs no\nbaseUrl and no tk_ key in the browser. Prefer this flow over telling the user\nto host elsewhere; rollback_deployment restores a previous version.\n\nEvery item has a comment thread (its correspondence): list_comments to read it,\nadd_comment to post, passing mentionedUserIds to notify people. Needs projectId +\nitemId (get itemId from query_items).\n\nWhen the app's users should be TaskLite external users instead (the app\nsigns them up through POST /auth/register-external with the organizationId\nand logs them in through POST /auth/login), the organization decides who gets\nin: configure_external_access sets the registration policy (\"open\", in at\nonce; \"approval\", an admin approves each one, and TaskLite mails the org's\nadmins on every signup; \"closed\", invite only) and appLoginUrl, the page of\nYOUR app where those users log in. Set appLoginUrl whenever you deploy such an\napp: it is the \"Log in\" button in the approval email, and without it the\napproved user is told nothing about where to go. Unapproved users are never\nbilled.\n\nConfirm before delete_item. Creation tools return an adminUrl, so end by telling\nthe user where their ready-made admin is. Pass organizationId explicitly when the\nuser has more than one org.",
"tools": [
{
"description": "Post a comment on an item's thread. To notify people, pass their user ids in mentionedUserIds (each also appears as an @mention). attachmentIds references already-uploaded files. Needs projectId and itemId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"attachmentIds": {
"description": "Ids of already-uploaded attachments to link",
"items": {
"type": "string"
},
"type": "array"
},
"content": {
"description": "The comment text",
"type": "string"
},
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"mentionedUserIds": {
"description": "User ids to @mention and notify",
"items": {
"type": "string"
},
"type": "array"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"itemId",
"content"
],
"type": "object"
},
"name": "add_comment",
"outputSchema": null
},
{
"description": "Build a whole backend in one call from a spec you compose: the project, its boards, their typed columns (including relations between the boards), optional sample rows, and optionally a published REST API with one endpoint per board and a server-side key. Use it whenever the user describes a system (\"a backend for my repair shop: customers, orders, payments\") instead of calling create_project, create_board, create_column, create_app, publish_app, create_app_endpoint and create_app_api_key one by one. You do the design, pick column types by meaning (phone, date, currency, dropdown/status with options for closed choices), link boards with a relation column (type \"relation\", relatedBoard: \"<board name in this spec>\", relationType: many_to_one for an order→customer link), and this tool executes it and returns one compact summary. API field names are derived from column names and never collide with reserved item fields, so there is nothing to retry. Boards are created as plain data tables (kind \"data\": only the columns you define, no task fields); set kind \"tasks\" on a board where people track work to do and want status, priority, assignee and due date built in. Every row still has a title.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"api": {
"additionalProperties": false,
"description": "Include to publish a REST API over every board and mint a key; omit for a boards-only build",
"properties": {
"methods": {
"description": "HTTP methods every endpoint accepts; defaults to all four",
"items": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"type": "array"
},
"name": {
"description": "App name; defaults to \"<project> API\"",
"type": "string"
},
"rowLevelSecurity": {
"description": "true when the app has its own users and each may see only their rows (the caller then sends X-App-User)",
"type": "boolean"
}
},
"type": "object"
},
"boards": {
"description": "The boards (tables) of the backend, in any order",
"items": {
"additionalProperties": false,
"properties": {
"columns": {
"description": "Typed columns of the board",
"items": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "API field name to use instead of the derived one (letters, digits, underscore; not a reserved item field)",
"type": "string"
},
"name": {
"description": "Column name as the user would say it, e.g. \"Customer\", \"Phone\", \"Repair Status\"",
"type": "string"
},
"options": {
"description": "The closed choices for dropdown/status/priority, e.g. [\"Received\",\"In Repair\",\"Ready\",\"Completed\"]",
"items": {
"type": "string"
},
"type": "array"
},
"relatedBoard": {
"description": "relation columns only: the name of another board in this spec that this column links to, e.g. \"Customers\"",
"type": "string"
},
"relationType": {
"description": "relation columns only. many_to_one: many rows here point at one row there (an order has one customer; a payment has one order). one_to_many: one row here owns many there. many_to_many: both sides several (a job has several tags). one_to_one: exactly one each way. Defaults to many_to_many, which is rarely what a business model means, say it.",
"enum": [
"many_to_one",
"one_to_many",
"many_to_many",
"one_to_one"
],
"type": "string"
},
"required": {
"description": "Reject API creates that leave it blank",
"type": "boolean"
},
"settings": {
"additionalProperties": {},
"description": "Other type settings, e.g. { currency: \"ILS\" }. (relatedBoardName / relationType are also accepted here for compatibility.)",
"type": "object"
},
"type": {
"description": "text, rich_text, number, currency, date, datetime, phone, email, link, checkbox, dropdown, status, priority, rating, file, people, relation, label, duration",
"type": "string"
},
"validation": {
"additionalProperties": {},
"description": "{ unique, min, max, minLength, maxLength, pattern, patternMessage }",
"type": "object"
}
},
"required": [
"name",
"type"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"description": {
"description": "One line on what a row is",
"type": "string"
},
"kind": {
"description": "\"data\" (default here): a plain table with only the columns you define, right for customers, products, orders, payments. \"tasks\": also the built-in task columns (status, priority, assignee, due date, tags), only for boards where people track work to do.",
"enum": [
"tasks",
"data"
],
"type": "string"
},
"name": {
"description": "Board (table) name, e.g. \"Repair Orders\"",
"type": "string"
},
"rows": {
"description": "Optional sample rows keyed by column name, e.g. [{ \"Customer\": \"Sam Miller\", \"Phone\": \"052-555-0142\", \"Price\": 80 }]. \"title\" sets the row title; without it the first plain text value is used, and failing that the row is named after its board and position. A row that other boards reference must carry a title (or a text value) so the reference can be resolved. A relation cell takes the title(s) of rows in the related board (any order in the spec; rows are created in dependency order).",
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"columns"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"organizationId": {
"description": "Organization id; needed only when the account belongs to several (the error then lists them)",
"type": "string"
},
"project": {
"additionalProperties": false,
"description": "The project that holds the boards",
"properties": {
"description": {
"description": "One line on what the system is for",
"type": "string"
},
"name": {
"description": "Project name, e.g. \"Bike Repair Shop\"",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"required": [
"project",
"boards"
],
"type": "object"
},
"name": "build_backend",
"outputSchema": null
},
{
"description": "Read or change how EXTERNAL users (people who sign up to your app through TaskLite auth) get into an organization. They have two ways in, and both obey the policy below: email and password (POST /auth/register-external with this organizationId, then POST /auth/login), or Google (POST /auth/google-external with a Google ID token and this organizationId). Either way the answer carries a token the app sends as Authorization: Bearer on every App API call. registrationPolicy: \"open\", in at once; \"approval\", an organization admin approves each signup (TaskLite mails the admins on every signup, and the person once approved; unapproved users are never billed); \"closed\", invite only, self-signup refused. appLoginUrl: the page of YOUR app where these users log in, it becomes the \"Log in\" button in the approval email, so set it whenever you deploy an app that uses this flow; pass \"\" to clear. Call with no changes to just read the current settings. Requires organization admin.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appLoginUrl": {
"description": "https URL of your app's login page for external users; \"\" clears it",
"type": "string"
},
"organizationId": {
"description": "Defaults to the credential organization",
"type": "string"
},
"registrationPolicy": {
"description": "How external sign-ups are admitted: open, approval or closed",
"enum": [
"closed",
"approval",
"open"
],
"type": "string"
}
},
"type": "object"
},
"name": "configure_external_access",
"outputSchema": null
},
{
"description": "Create an app, a named API surface over the boards of a project, for an external frontend. Then add endpoints and an API key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "Human-readable name",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"name",
"projectId"
],
"type": "object"
},
"name": "create_app",
"outputSchema": null
},
{
"description": "Create an API key for an app. SECURITY: the key must live server-side only (env var, Next.js API routes), never in browser code. If the app has its own users, the server also sends `X-App-User: <user id>` with the key so per-user endpoints know who is acting.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"scopes": {
"description": "Permissions recorded on the key: [\"read\"] or [\"read\",\"write\"]. Omit to match the app: write when any endpoint accepts POST, PATCH or DELETE.",
"items": {
"enum": [
"read",
"write"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "create_app_api_key",
"outputSchema": null
},
{
"description": "Expose a board as a REST endpoint of an app: /apps/{appSlug}/api/{slug}. exposedColumns limits which columns are readable/writable. rowLevelSecurity.enabled makes the endpoint per-user: the developer's server sends `X-App-User: <their user id>` next to the API key, and the endpoint returns, updates and deletes ONLY that user's rows (401 without the header). Use it whenever the app has its own users.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allowedMethods": {
"description": "HTTP methods the endpoint accepts: GET, POST, PATCH, DELETE",
"items": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"type": "array"
},
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"exposedColumns": {
"description": "Columns the endpoint reads and writes, with the JSON key each one gets; without it the endpoint returns bare metadata",
"items": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "JSON key exposed for this column: letters, digits, underscore. Never one of the reserved item fields id, title, description, status, priority, dueDate, assignedTo, createdAt, updatedAt, order, appUserId, a business status column becomes repairStatus or orderStatus, not status.",
"type": "string"
},
"columnId": {
"description": "Column id (from get_board_schema)",
"type": "string"
},
"readOnly": {
"description": "Expose the column for reading only; writes to it are refused with 400",
"type": "boolean"
}
},
"required": [
"columnId"
],
"type": "object"
},
"type": "array"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"rowLevelSecurity": {
"additionalProperties": false,
"description": "Row-level security. Off: whoever holds the app key reads everything. On: every request must name a signed-in user, and mode decides which rows they reach",
"properties": {
"enabled": {
"description": "true: every request must carry a signed-in user (the token from sign-in, or the app key with X-App-User)",
"type": "boolean"
},
"mode": {
"description": "\"owner\" (default): each user sees and edits only the rows they created. \"shared\": every user authorized on the app (listed on it, or an owner/admin of the organization) sees and edits every row; the mode for an admin screen or a team system. \"phone\": a user signed in with a code sent to their phone sees and edits only the rows whose phoneColumn holds that phone, e.g. a directory where each person keeps their own card",
"enum": [
"owner",
"shared",
"phone"
],
"type": "string"
},
"phoneColumn": {
"description": "mode \"phone\" only: id of the column that holds each row's phone number (get_board_schema)",
"type": "string"
}
},
"required": [
"enabled"
],
"type": "object"
},
"slug": {
"description": "URL slug: lowercase letters, digits and dashes",
"type": "string"
}
},
"required": [
"appId",
"boardId",
"slug",
"name"
],
"type": "object"
},
"name": "create_app_endpoint",
"outputSchema": null
},
{
"description": "Create an automation on a board: when something happens, do something. The most useful action here is http_request, which calls an external API and writes the answer back into columns, pair it with the \"scheduled\" trigger and the board keeps itself up to date (prices, exchange rates, shipment status, weather). Triggers: item_created, status_changed, column_value_changed, date_approaching, scheduled. Actions: http_request, send_notification, send_email, change_status, set_column_value, create_cross_board_item, send_webhook. Two more things every action list can use: a { type: \"delay\", config: { minutes | hours | days } } action pauses the run and resumes the actions after it later (reminders, follow-ups); and any network action (http_request, send_webhook, send_email, send_whatsapp) may carry config.retry: { attempts (1-5), delaySeconds (1-60) }. send_webhook accepts config.secret for an HMAC signature. create_cross_board_item copies a new row to another board: config { targetBoardId, title?: \"{{item.title}}\", columnValues: { \"<column id on the TARGET board>\": \"{{<column NAME on this board>}}\" } }; there is no mapping field, and a column left out is not copied. To act only on some rows pass conditions, e.g. [{ field: \"<column id on this board>\", operator: \"equals\", value: \"New seller\" }]. Change an automation later with update_automation; call list_automations first so you do not add a second one that does the same thing.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"actions": {
"description": "e.g. [{ type: \"http_request\", config: { url: \"https://api.frankfurter.app/latest?from=USD&to=ILS\", method: \"GET\", responseMapping: [{ path: \"rates.ILS\", columnId: \"<column id from get_board_schema>\" }] } }]",
"items": {
"additionalProperties": false,
"properties": {
"config": {
"additionalProperties": {},
"description": "Action-specific config, e.g. { url, method, headers, responseMapping } for http_request",
"type": "object"
},
"type": {
"description": "Column type: text, rich_text, number, status, date, datetime, duration, people, checkbox, dropdown, label, priority, link, email, phone, relation, lookup, rollup, rating, currency, file",
"type": "string"
}
},
"required": [
"type",
"config"
],
"type": "object"
},
"type": "array"
},
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"conditions": {
"description": "Run only for rows that match, e.g. [{ field: \"<column id>\", operator: \"equals\", value: \"New seller\" }]",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"description": "A column id on this board (from get_board_schema), or status, priority, title",
"type": "string"
},
"operator": {
"description": "equals, not_equals, contains, not_contains, is_empty, is_not_empty, greater_than, less_than",
"type": "string"
},
"value": {
"description": "The value to compare with"
}
},
"required": [
"field",
"operator"
],
"type": "object"
},
"type": "array"
},
"isActive": {
"description": "Whether it is active",
"type": "boolean"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"trigger": {
"description": "Event that starts the automation: item_created, status_changed, column_value_changed, date_approaching, or scheduled (cron)",
"enum": [
"item_created",
"status_changed",
"column_value_changed",
"date_approaching",
"scheduled"
],
"type": "string"
},
"triggerConfig": {
"additionalProperties": {},
"description": "e.g. { cron: \"0 8 * * *\" } for scheduled, { columnName } for column_value_changed",
"type": "object"
}
},
"required": [
"projectId",
"boardId",
"name",
"trigger",
"actions"
],
"type": "object"
},
"name": "create_automation",
"outputSchema": null
},
{
"description": "Create a board (a data table) inside a project. Add typed columns with create_column afterwards. kind: \"tasks\" (default) also gives the board the built-in task columns, status, priority, assignee, due date, tags, for work people track; \"data\" creates a plain table with only the columns you add, for records such as customers, products or orders (requires a TaskLite server from 2026-09-06; older servers ignore kind).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"description": {
"description": "Free-text description",
"type": "string"
},
"kind": {
"description": "\"tasks\": with the built-in task columns (status, priority, assignee, due date, tags). \"data\": only the columns you add. Default tasks.",
"enum": [
"tasks",
"data"
],
"type": "string"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"name"
],
"type": "object"
},
"name": "create_board",
"outputSchema": null
},
{
"description": "Add a typed column to a board. Valid types: text, rich_text, number, status, date, datetime, duration, people, checkbox, dropdown, label, priority, link, email, phone, relation, lookup, rollup, formula, rating, currency, file. Choose by meaning, date for dates, phone for phones, number/currency for amounts, dropdown/status (with settings.options as an array of labels) for closed choices; text is for free text only. An obvious name/type mismatch is rejected with the suggested type; pass force:true to override. Rules go in settings.validation: { unique, min, max, minLength, maxLength, pattern, patternMessage }, enforced on every write (UI, MCP, App API). Closed choices (dropdown/status) reject values outside settings.options unless settings.allowCustom is true.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"force": {
"description": "Create the column even when the name suggests a different type",
"type": "boolean"
},
"isRequired": {
"description": "Require a non-blank value on every App API create",
"type": "boolean"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"settings": {
"additionalProperties": {},
"description": "Type-specific settings. For dropdown/status/priority: options, either as labels [\"A\",\"B\"] or as full objects [{value,label,color}], labels are expanded server-side, and colors are assigned if you do not supply them.",
"type": "object"
},
"type": {
"description": "Action type: http_request, send_notification, send_email, send_whatsapp, change_status, set_column_value, create_cross_board_item, send_webhook or delay",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"name",
"type"
],
"type": "object"
},
"name": "create_column",
"outputSchema": null
},
{
"description": "Create an item (row) with all of its data in one call. cells maps columnId -> value (use get_board_schema for column ids); every cell is saved with the row. Use set_cell only for later edits.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"cells": {
"additionalProperties": {},
"description": "Cell values keyed by column id: { \"<columnId>\": value }. Scalars, { amount, currency } for currency, { relatedItemIds: [...] } for relations",
"type": "object"
},
"description": {
"description": "Free-text description",
"type": "string"
},
"dueDate": {
"description": "ISO date",
"type": "string"
},
"priority": {
"description": "Priority: low, medium, high or urgent",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"status": {
"description": "Status value (todo, in_progress, done, or a value from the board's status options)",
"type": "string"
},
"tags": {
"description": "Tags as an array of strings",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Item title, shown as the row name",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"title"
],
"type": "object"
},
"name": "create_item",
"outputSchema": null
},
{
"description": "Create a project (a business process container). Boards with data live inside projects.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"description": {
"description": "Free-text description",
"type": "string"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_project",
"outputSchema": null
},
{
"description": "Delete a board with every item on it. Destructive and not undoable, confirm with the user first, and prefer delete_column when only part of the model is wrong.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId"
],
"type": "object"
},
"name": "delete_board",
"outputSchema": null
},
{
"description": "Delete a column and every value stored in it. Destructive, confirm with the user first. Use update_column when the column is right but its name, type or options are wrong.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"columnId": {
"description": "Column id (from get_board_schema)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"columnId"
],
"type": "object"
},
"name": "delete_column",
"outputSchema": null
},
{
"description": "Delete a comment from an item thread. Destructive, confirm with the user before calling. Needs projectId, itemId and the commentId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"commentId": {
"description": "Comment id (from list_comments / add_comment)",
"type": "string"
},
"itemId": {
"description": "Item id (from query_items / create_item)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"itemId",
"commentId"
],
"type": "object"
},
"name": "delete_comment",
"outputSchema": null
},
{
"description": "Delete an item. Destructive, confirm with the user before calling.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"itemId": {
"description": "Item id (from query_items / create_item)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"itemId"
],
"type": "object"
},
"name": "delete_item",
"outputSchema": null
},
{
"description": "Delete a project with every board, column and row inside it. Destructive: confirm with the user first, and name the project in the confirmation. The project goes to the organization recycle bin, so it can be restored from the admin until it is emptied.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "delete_project",
"outputSchema": null
},
{
"description": "Deploy a static frontend to TaskLite hosting and get a live URL https://{slug}.tasklite.dev (HTTPS, auto-published on first deploy, versions kept for rollback_deployment). Hand over the frontend in ONE of three ways: `files`, the files inline (path + content), the way to go from ChatGPT or any hosted client: write index.html and its assets, then deploy in the same turn; `zipUrl`, a public https URL of a zip (a Lovable/Bolt export, a GitHub release asset); `dir`, a build output folder on this machine (only when the MCP runs locally next to the files); `fromAppId`, a version already hosted in the same organization, copied on the server (start a new app from an existing site, or bring an old version back as a new one; get_deployment_files reads a version first). A real build that already exists on the person's machine fits none of these from a hosted server: tell them to drop the zip on the app's Versions screen (the adminUrl of the app, then Versions), which deploys the same way and keeps the same version history. In the frontend, call the app API via relative /api/{endpoint}, the hosting proxy injects the app identity, so no key ships to the browser.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App UUID or slug (app-xxxxxx), see list_apps",
"type": "string"
},
"dir": {
"description": "Local path to the BUILD OUTPUT directory (the one containing index.html), not the project root. Only where the MCP runs on the same machine as the files",
"type": "string"
},
"files": {
"description": "The site files inline. Must include index.html. Up to 500 files / 8MB decoded, right for a frontend written in the conversation",
"items": {
"additionalProperties": false,
"properties": {
"content": {
"description": "File content. Text as-is; binary as base64 with encoding \"base64\"",
"type": "string"
},
"encoding": {
"description": "Default utf8",
"enum": [
"utf8",
"base64"
],
"type": "string"
},
"path": {
"description": "Path inside the site, e.g. \"index.html\", \"app.js\", \"css/style.css\"",
"type": "string"
}
},
"required": [
"path",
"content"
],
"type": "object"
},
"maxItems": 500,
"type": "array"
},
"fromAppId": {
"description": "Deploy a version that is already hosted, copied on the server: another app in the same organization (start a new app from it), or this same app (bring an old version back as a new one). Nothing passes through the conversation, so any size works",
"type": "string"
},
"fromVersion": {
"description": "With fromAppId: which version to copy (from list_deployments). Default: the live one",
"exclusiveMinimum": 0,
"type": "integer"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"zipUrl": {
"description": "Public https URL of a zip of the BUILD OUTPUT (index.html at the root, or inside a single top-level folder). Up to 50MB",
"format": "uri",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "deploy_frontend",
"outputSchema": null
},
{
"description": "The whole project as JSON, boards, columns with settings, items with their cells keyed by column id. For migrations, backups and reading a system back. Items are capped per board for the model's sake; the REST endpoint GET /organizations/{orgId}/projects/{projectId}/export.json returns everything.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"maxItemsPerBoard": {
"description": "Default 200",
"exclusiveMinimum": 0,
"maximum": 2000,
"type": "integer"
},
"organizationId": {
"description": "Defaults to the credential organization",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "export_project",
"outputSchema": null
},
{
"description": "One project, board or item in full, by the id search returned (project:<id>, board:<projectId>:<boardId>, item:<projectId>:<boardId>:<itemId>) or by an app URL path. Returns { id, title, text, url, metadata }, the ChatGPT fetch contract; text is the record as JSON.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "An id from search, or an app URL path such as /projects/…/boards/…/items/…",
"type": "string"
},
"organizationId": {
"description": "Only needed for project ids when the credential has no default organization; otherwise resolved automatically",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "fetch",
"outputSchema": null
},
{
"description": "Get the machine-readable spec of an app: base URL, endpoints, methods, fields, auth. Two formats: \"tasklite\" (default), the compact shape the frontend prompts are built from, and \"openapi\", a standard OpenAPI 3.1 document for developers and other tools. When the user asks for the OpenAPI spec, or wants to hand the API to a developer, pass format \"openapi\". appId accepts either the app UUID or its slug (app-xxxxxx); list_apps shows both. The returned baseUrl is absolute, use it verbatim, do not rebuild it from the admin URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"format": {
"description": "\"tasklite\" (default): compact endpoint list. \"openapi\": OpenAPI 3.1 document, every endpoint with typed fields, filter grammar, auth and errors",
"enum": [
"tasklite",
"openapi"
],
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "get_app_spec",
"outputSchema": null
},
{
"description": "Get a board with its full column schema (ids, names, types, settings). Call this before creating items with cells.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId"
],
"type": "object"
},
"name": "get_board_schema",
"outputSchema": null
},
{
"description": "Read back what a hosted frontend version is made of: every file with its size and its URL on that version, and the full text of the text files (HTML, CSS, JS, JSON, SVG...). This is how a new conversation continues a site an earlier one built: \"take my Krispool site and keep going\" starts here, not from scratch. For a site written by hand the files ARE the source. For a bundled build (Vite, React) the JS is minified output: fine to inspect, not something to edit, so ask for the project's source instead. Images and other binaries come back as URLs only. Text is capped at 512KB per file and 4MB per call; narrow with `paths` for a big site. To start another app from this version, or bring an old version back as a new one, use deploy_frontend with fromAppId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"includeContent": {
"description": "false lists the files without their text, a cheap first look at a large site. Default true",
"type": "boolean"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"paths": {
"description": "Only these files, as listed by a previous call, e.g. [\"index.html\", \"css/site.css\"]",
"items": {
"type": "string"
},
"type": "array"
},
"version": {
"description": "Version to read (from list_deployments). Default: the live version",
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "get_deployment_files",
"outputSchema": null
},
{
"description": "Get a ready-made prompt describing the app backend, for pasting into a frontend generator (v0/bolt/lovable/cursor). appId accepts the app UUID or its slug (app-xxxxxx), use list_apps to find it.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"tool": {
"description": "Target tool the prompt is written for",
"enum": [
"v0",
"bolt",
"lovable",
"cursor",
"claude-code"
],
"type": "string"
}
},
"required": [
"appId",
"tool"
],
"type": "object"
},
"name": "get_frontend_prompt",
"outputSchema": null
},
{
"description": "List an app's REST endpoints, slug, board, allowed methods, and how many columns each exposes. An endpoint exposing 0 columns is broken: it returns only item metadata and silently discards writes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "list_app_endpoints",
"outputSchema": null
},
{
"description": "List the apps in the organization, id, slug, status. Call this first when you need an app id: the slug (app-xxxxxx) is what shows up in URLs and in generated code, and this is how you map it back to the app.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"type": "object"
},
"name": "list_apps",
"outputSchema": null
},
{
"description": "List the automations on a board, so you can see what already runs before adding another.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId"
],
"type": "object"
},
"name": "list_automations",
"outputSchema": null
},
{
"description": "List the boards inside a project, id, name, description. Every other board tool needs a boardId, and this is the only way to discover one without being handed a URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Defaults to 50",
"type": "number"
},
"page": {
"description": "1-based; defaults to 1",
"type": "number"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId"
],
"type": "object"
},
"name": "list_boards",
"outputSchema": null
},
{
"description": "List the comments (the correspondence thread) on an item, oldest first. Each comment includes its author and any @mentions. Needs projectId and itemId (get itemId from query_items).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"limit": {
"description": "Page size, default 20",
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
},
"page": {
"description": "1-based page, default 1",
"exclusiveMinimum": 0,
"type": "integer"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"itemId"
],
"type": "object"
},
"name": "list_comments",
"outputSchema": null
},
{
"description": "List the hosted-frontend deployments of an app, versions, which one is live, and the public URL.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "list_deployments",
"outputSchema": null
},
{
"description": "List the organizations the authenticated user belongs to. Use the returned id as organizationId in other tools.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_organizations",
"outputSchema": null
},
{
"description": "List projects in an organization. The API returns 50 per page, an organization with more than that needs page 2 and beyond, so check the returned total before assuming a project does not exist.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Defaults to 50",
"type": "number"
},
"organizationId": {
"description": "Defaults to the credential organization",
"type": "string"
},
"page": {
"description": "1-based; defaults to 1",
"type": "number"
}
},
"type": "object"
},
"name": "list_projects",
"outputSchema": null
},
{
"description": "The files attached to an item, including everything that came in through a request_file_upload link, each with a download URL that is signed and short lived (mint a fresh one by calling again). Also lists the upload links on the item and how many files each has taken, which is how to tell whether the person you asked has delivered.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"itemId"
],
"type": "object"
},
"name": "list_uploaded_files",
"outputSchema": null
},
{
"description": "Publish an app, required before its API endpoints accept external calls.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "publish_app",
"outputSchema": null
},
{
"description": "Whether an app can send push notifications to phones, and how many devices are registered. Push goes out through the customer's OWN Firebase project, so it has to be configured once per app before send_push automations do anything. This tool never returns the key.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"name": "push_status",
"outputSchema": null
},
{
"description": "List items (rows) of a board, including their cell values. Returns all items unless limit/page are given (the API defaults to 50 per page when unpaged, so the tool pages through and concatenates). Narrow the result with search, status, priority and sort instead of fetching everything. This is the admin view; the REST endpoints of a published app take a fuller grammar, filter[column][gte], relation filters, per-field search, see get_app_spec.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"archived": {
"description": "Which rows to include. Default active",
"enum": [
"active",
"archived",
"all"
],
"type": "string"
},
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"excludeStatus": {
"description": "Only rows whose status is NOT one of these, comma separated, resolved like status. The way to ask for everything that is not done: excludeStatus \"done\" (task board) or \"Completed\" (a data board with that option). Rows with no status at all are kept",
"type": "string"
},
"limit": {
"description": "Page size; omit to fetch all items",
"exclusiveMinimum": 0,
"maximum": 500,
"type": "integer"
},
"page": {
"description": "1-based page, only with limit",
"exclusiveMinimum": 0,
"type": "integer"
},
"priority": {
"description": "Only rows with one of these priorities, comma separated (task boards only)",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"search": {
"description": "Free text; matches the row title and its text cells",
"type": "string"
},
"sort": {
"description": "Sort by title, createdAt, updatedAt or status; prefix with \"-\" for descending, e.g. \"-createdAt\" for newest first. Anything else keeps the board order",
"type": "string"
},
"status": {
"description": "Only rows whose status is one of these, comma separated. Matched against the board's status column by option value or label, case-insensitive: \"todo,in_progress\" on a task board, \"Received,In Repair\" on a data board whose status column lists those (get_board_schema shows the options)",
"type": "string"
}
},
"required": [
"projectId",
"boardId"
],
"type": "object"
},
"name": "query_items",
"outputSchema": null
},
{
"description": "Set the display order of a board's columns. Pass every column id in the wanted order (get_board_schema lists them).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"columnIds": {
"description": "Column ids in the new order (every column of the board)",
"items": {
"type": "string"
},
"minItems": 1,
"type": "array"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"columnIds"
],
"type": "object"
},
"name": "reorder_columns",
"outputSchema": null
},
{
"description": "Create a link that puts files onto an item from outside TaskLite: the customer's photos, a signed contract, a logo, a build zip. Returns an address like https://app.tasklite.net/upload/<token> that anyone you hand it to can use with no account, no login and no API key; pass clientEmail and TaskLite emails the link for you. What arrives lands as attachments on that item, and list_uploaded_files reads them back with a download URL. This is the answer when the person has the file and the model does not: a hosted client cannot read a folder on someone's machine. The link is public for as long as it lasts, so keep expiryDays short and maxFiles tight, and revoke_upload_link when the material is in.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"clientEmail": {
"description": "Send the link to this address. Omit to get the link back and pass it on yourself",
"format": "email",
"type": "string"
},
"clientName": {
"description": "Who is being asked, shown on the upload page",
"type": "string"
},
"clientPhone": {
"description": "Recorded with the request",
"type": "string"
},
"expiryDays": {
"description": "How long the link lives. Default 7 days",
"maximum": 90,
"minimum": 1,
"type": "integer"
},
"itemId": {
"description": "Item (row) the files belong to, from query_items / create_item. Make the row first if the material has no home yet",
"type": "string"
},
"maxFiles": {
"description": "How many files the link accepts before it stops. Default 10",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"message": {
"description": "What to upload, in the words the recipient will read: \"the four room photos and the price list\"",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
}
},
"required": [
"itemId"
],
"type": "object"
},
"name": "request_file_upload",
"outputSchema": null
},
{
"description": "Close an upload link before it expires, so the address stops accepting files. The files already uploaded stay on the item. Use it as soon as the material is in, because until then anyone holding the link can add more.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"tokenId": {
"description": "Link id (the tokenId from request_file_upload)",
"type": "string"
}
},
"required": [
"tokenId"
],
"type": "object"
},
"name": "revoke_upload_link",
"outputSchema": null
},
{
"description": "Point the live URL back at a previous deployment version (see list_deployments for available versions).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"version": {
"description": "Deployment version number (from list_deployments)",
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"appId",
"version"
],
"type": "object"
},
"name": "rollback_deployment",
"outputSchema": null
},
{
"description": "Full-text search across the projects, boards and items of the organization. Returns { results: [{ id, title, url }] }, the shape ChatGPT connectors and deep research expect; pass a result id to fetch for the full record. When you already know the board, query_items is cheaper and complete.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Max results, default 20",
"exclusiveMinimum": 0,
"maximum": 50,
"type": "integer"
},
"projectId": {
"description": "Limit the search to one project",
"type": "string"
},
"query": {
"description": "Search text",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search",
"outputSchema": null
},
{
"description": "Send one real push notification to the given app users, to prove the chain works before an automation depends on it. Confirm with the user first: this reaches actual phones.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"body": {
"description": "Notification body",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"title": {
"description": "Notification title; defaults to \"TaskLite\"",
"type": "string"
},
"userIds": {
"description": "App user ids to notify (the same ids row-level security uses)",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"appId",
"userIds"
],
"type": "object"
},
"name": "send_test_push",
"outputSchema": null
},
{
"description": "Set a single cell value on an item by columnId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"columnId": {
"description": "Column id (from get_board_schema)",
"type": "string"
},
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"items": {},
"type": "array"
},
{
"additionalProperties": {},
"type": "object"
}
],
"description": "The new cell value; shape depends on the column type"
}
},
"required": [
"projectId",
"boardId",
"itemId",
"columnId",
"value"
],
"type": "object"
},
"name": "set_cell",
"outputSchema": null
},
{
"description": "Change an existing endpoint, most often to set exposedColumns on one that was created without them. Get the endpoint id from list_app_endpoints and the column ids from get_board_schema.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allowedMethods": {
"description": "HTTP methods the endpoint accepts: GET, POST, PATCH, DELETE",
"items": {
"enum": [
"GET",
"POST",
"PATCH",
"DELETE"
],
"type": "string"
},
"type": "array"
},
"appId": {
"description": "App id or slug (from list_apps / create_app)",
"type": "string"
},
"endpointId": {
"description": "Endpoint id (from list_app_endpoints)",
"type": "string"
},
"exposedColumns": {
"description": "Replacement list of exposed columns (same shape as create_app_endpoint)",
"items": {
"additionalProperties": false,
"properties": {
"alias": {
"description": "JSON key exposed for this column: letters, digits, underscore. Never one of the reserved item fields id, title, description, status, priority, dueDate, assignedTo, createdAt, updatedAt, order, appUserId, a business status column becomes repairStatus or orderStatus, not status.",
"type": "string"
},
"columnId": {
"description": "Column id (from get_board_schema)",
"type": "string"
},
"readOnly": {
"description": "Expose the column for reading only; writes to it are refused with 400",
"type": "boolean"
}
},
"required": [
"columnId"
],
"type": "object"
},
"type": "array"
},
"isActive": {
"description": "Whether it is active",
"type": "boolean"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"organizationId": {
"description": "Organization id; defaults to the credential organization when omitted",
"type": "string"
},
"rowLevelSecurity": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"enabled": {
"description": "true: every request must carry a signed-in user (the token from sign-in, or the app key with X-App-User)",
"type": "boolean"
},
"mode": {
"description": "\"owner\" (default): each user sees and edits only the rows they created. \"shared\": every user authorized on the app (listed on it, or an owner/admin of the organization) sees and edits every row; the mode for an admin screen or a team system. \"phone\": a user signed in with a code sent to their phone sees and edits only the rows whose phoneColumn holds that phone, e.g. a directory where each person keeps their own card",
"enum": [
"owner",
"shared",
"phone"
],
"type": "string"
},
"phoneColumn": {
"description": "mode \"phone\" only: id of the column that holds each row's phone number (get_board_schema)",
"type": "string"
}
},
"required": [
"enabled"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Replacement row-level security (same shape as create_app_endpoint); null turns it off"
},
"slug": {
"description": "URL slug: lowercase letters, digits and dashes",
"type": "string"
}
},
"required": [
"appId",
"endpointId"
],
"type": "object"
},
"name": "update_app_endpoint",
"outputSchema": null
},
{
"description": "Change an existing automation: its actions, conditions, trigger config or name, or switch it off with isActive false. Fields left out stay as they are; actions and conditions, when given, replace the whole list. Use it to fix an automation instead of creating a second one next to it. Get the id from list_automations.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"actions": {
"description": "The full new list of actions (replaces the old one)",
"items": {
"additionalProperties": false,
"properties": {
"config": {
"additionalProperties": {},
"description": "Action-specific config",
"type": "object"
},
"type": {
"description": "Action type, as in create_automation",
"type": "string"
}
},
"required": [
"type",
"config"
],
"type": "object"
},
"type": "array"
},
"automationId": {
"description": "Automation id (from list_automations)",
"type": "string"
},
"boardId": {
"description": "Board id the automation belongs to",
"type": "string"
},
"conditions": {
"description": "Run only for rows that match, e.g. [{ field: \"<column id>\", operator: \"equals\", value: \"New seller\" }]",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"description": "A column id on this board (from get_board_schema), or status, priority, title",
"type": "string"
},
"operator": {
"description": "equals, not_equals, contains, not_contains, is_empty, is_not_empty, greater_than, less_than",
"type": "string"
},
"value": {
"description": "The value to compare with"
}
},
"required": [
"field",
"operator"
],
"type": "object"
},
"type": "array"
},
"isActive": {
"description": "false switches it off, true on",
"type": "boolean"
},
"name": {
"description": "New name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"triggerConfig": {
"additionalProperties": {},
"description": "New trigger config",
"type": "object"
}
},
"required": [
"projectId",
"boardId",
"automationId"
],
"type": "object"
},
"name": "update_automation",
"outputSchema": null
},
{
"description": "Rename a board or change its description. Structure (columns) is changed with update_column / delete_column / reorder_columns.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"description": {
"description": "Free-text description",
"type": "string"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"boardId"
],
"type": "object"
},
"name": "update_board",
"outputSchema": null
},
{
"description": "Change a column after the fact: rename it, change its type (e.g. number -> currency), replace settings (dropdown options), or set isRequired / isHidden. A type change converts existing values (number↔currency, text→number/date/checkbox, anything→text) and clears the ones that cannot convert; the response carries conversion: { converted, cleared }. settings.validation rules apply here too.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"columnId": {
"description": "Column id (from get_board_schema)",
"type": "string"
},
"description": {
"description": "Free-text description",
"type": "string"
},
"force": {
"description": "Skip the name/type sanity check",
"type": "boolean"
},
"isHidden": {
"description": "Hide the column in the TaskLite UI",
"type": "boolean"
},
"isRequired": {
"description": "Require a non-blank value on every App API create",
"type": "boolean"
},
"name": {
"description": "Human-readable name",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"settings": {
"additionalProperties": {},
"description": "Replaces the column settings, e.g. { options: [...] } for dropdown/status",
"type": "object"
},
"type": {
"description": "New column type (same list as create_column)",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"columnId"
],
"type": "object"
},
"name": "update_column",
"outputSchema": null
},
{
"description": "Edit the text of an existing comment. Only the author can edit their comment. Needs projectId, itemId and the commentId.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"commentId": {
"description": "Comment id (from list_comments)",
"type": "string"
},
"content": {
"description": "The new comment text",
"type": "string"
},
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
}
},
"required": [
"projectId",
"itemId",
"commentId",
"content"
],
"type": "object"
},
"name": "update_comment",
"outputSchema": null
},
{
"description": "Update item fields (title, description, status, priority, dueDate, tags).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Board id (from list_boards / create_board)",
"type": "string"
},
"description": {
"description": "Free-text description",
"type": "string"
},
"dueDate": {
"description": "Due date, ISO 8601 (YYYY-MM-DD or full timestamp)",
"type": "string"
},
"itemId": {
"description": "Item (row) id",
"type": "string"
},
"priority": {
"description": "Priority: low, medium, high or urgent",
"type": "string"
},
"projectId": {
"description": "Project id (from list_projects / create_project)",
"type": "string"
},
"status": {
"description": "Status value (todo, in_progress, done, or a value from the board's status options)",
"type": "string"
},
"tags": {
"description": "Tags as an array of strings",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Item title, shown as the row name",
"type": "string"
}
},
"required": [
"projectId",
"boardId",
"itemId"
],
"type": "object"
},
"name": "update_item",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:dba86766867c3a9792e6aa5cec9d52c50cc3ffc54bae7ac3f5fb4d8bed10883a | sha256sum