# suppa-mcp-2

Source: https://glimind.com/server/npm%2Fsuppa-mcp-2
Registry id: `npm/suppa-mcp-2`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "suppa-mcp-2": {
      "command": "npx",
      "args": [
        "-y",
        "suppa-mcp-2"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add suppa-mcp-2 -- npx -y suppa-mcp-2
```

## Tools (80)

- `suppa_add_comment`: Add a comment (supports @mentions)
- `suppa_add_custom_field`: Create a custom field in one context (its set is created if missing)
- `suppa_add_custom_fields_batch`: Create MANY custom fields in ONE atomic call — one bad entry creates nothing
- `suppa_add_enum_values`: Add values to an enum field — the group is read from the field's subType
- `suppa_add_field`: Add a field to an entity (options_json: searchable / showInTable / canFilter …)
- `suppa_apply_custom_fields`: Apply a custom-field declaration FILE from the repo — idempotent, never deletes, dry run by default
- `suppa_attach_file`: Attach a local file to a task
- `suppa_attach_file_to_record`: Attach a local file to any record
- `suppa_change_field_type`: Change a field's type, converting every row — the platform's plan first, a refused plan never sent, a loss (locale loss, restoring an earlier column) sent only 
- `suppa_close_task`: Close a task (confirm-gated)
- `suppa_copy_record`: Duplicate a record, optionally with its files / related records
- `suppa_count_tasks`: Count tasks matching filters
- `suppa_create_blocks`: Create blocks from a JSON array (11 block types)
- `suppa_create_doc`: Create a doc
- `suppa_create_entity`: Create a new entity (options_json: comments / globalSearch / hierarchy …)
- `suppa_create_page`: Create a page
- `suppa_create_record`: Create a record — or a batch, by passing an array of records (one request)
- `suppa_create_tabular_part`: Create a tabular part (owned rows) of a parent
- `suppa_create_task`: Create a task
- `suppa_delete_block`: Delete a block (confirm-gated)
- `suppa_delete_doc`: Delete a doc (confirm-gated)
- `suppa_delete_page`: Delete a page (confirm-gated)
- `suppa_delete_record`: Soft-delete a record — reversible (confirm-gated); permanent delete is blocked server-wide
- `suppa_delete_task`: Delete a task (confirm-gated)
- `suppa_describe_entity`: Field definitions + types for an entity (compact by default; full=true for the raw schema)
- `suppa_diagnostics`: Validate the whole multi-tenant setup
- `suppa_download_file`: Download one attachment (original, preview, or generated PDF)
- `suppa_download_files_zip`: Download several attachments as a ZIP
- `suppa_get_automation`: Get one automation as a normalized graph (nodes + edges)
- `suppa_get_automation_run`: Get one run with per-node steps + trigger payload
- `suppa_get_blocks`: Get raw blocks of a page
- `suppa_get_comments`: Get comments on a task
- `suppa_get_doc`: Get a doc (page tree included, or only fields_json)
- `suppa_get_me`: Current authenticated user's profile
- `suppa_get_page`: Get a page (metadata, or only fields_json)
- `suppa_get_record`: Get a single record (deleted_scope reads a soft-deleted one)
- `suppa_get_task`: Get a single task (full details, or only fields_json)
- `suppa_health_check`: Config + upstream connectivity check (reports version)
- `suppa_insert_block`: Insert a block at a position
- `suppa_link_custom_field`: Put an existing custom field into another context, take it out, or set required there (confirm-gated)
- `suppa_list_automation_node_types`: Node-type catalog (authoritative + fallback)
- `suppa_list_automation_runs`: List runs (executions) of an automation
- `suppa_list_automations`: List automation workflows
- `suppa_list_docs`: List docs (fields_json narrows each row)
- `suppa_list_entities`: List entities (tables)
- `suppa_list_field_types`: List supported field types
- `suppa_list_pages`: List pages of a doc (fields_json narrows each row)
- `suppa_list_record_files`: List the files attached to a record
- `suppa_list_stages`: List stages of a workflow
- `suppa_list_tabular_parts`: List tabular parts (ТЧ) of an entity
- `suppa_list_task_types`: List task types
- `suppa_list_tenants`: List known tenants + which is active / authenticated
- `suppa_list_workflows`: List Task workflows
- `suppa_login`: Google browser sign-in for a tenant (stores tokens in OS keychain)
- `suppa_logout`: Remove stored credentials for a tenant
- `suppa_move_task`: Move a task to another stage (confirm-gated)
- `suppa_query`: Run one read-only SuppaSQL statement (SELECT/WITH) with the caller's read permissions — check a SQL chart or table source before writing the form
- `suppa_query_analyze`: One analysis of a final query: its plan for you and every role, the tables' storage and indexes, the index / rewrite actions to propose (none applied). Plan onl
- `suppa_read_page`: Read a page rendered to text
- `suppa_remove_custom_field`: Soft-remove custom fields; the column is parked, not dropped (confirm-gated)
- `suppa_reorder_blocks`: Reorder blocks on a page
- `suppa_resolve_custom_fields`: Which custom fields are live for a record or context, and their values
- `suppa_restore_custom_field`: Put a removed custom field and its values back (confirm-gated)
- `suppa_restore_record`: Undo a soft delete: clear deletedAt on a record (confirm-gated)
- `suppa_search_records`: Search / filter records in any entity — nested AND/OR groups, auto-diagnoses an empty result (deleted_scope finds soft-deleted rows)
- `suppa_search_tasks`: Search tasks (my / active / overdue / due-today filters, paginated); task_ids reads several known tasks in one call; fields_json narrows each row
- `suppa_search_users`: Search users (feeds assignee / mentions)
- `suppa_set_title_field`: Set the representative/title field
- `suppa_sql_kb`: The SuppaSQL skill offline: rules, cheat sheet, common mistakes, references by section, and check — what the platform refuses and the measured slow shapes a dra
- `suppa_update_block`: Update a block (confirm-gated)
- `suppa_update_doc`: Update a doc (confirm-gated)
- `suppa_update_entity_options`: Toggle the 20 per-entity features — comments, hierarchy, approvals, customFields … (confirm-gated)
- `suppa_update_field`: Edit an existing field — name, title, flags, options, encryption (confirm-gated)
- `suppa_update_page`: Update a page (confirm-gated)
- `suppa_update_record`: Update a record (confirm-gated)
- `suppa_update_task`: Update a task (confirm-gated)
- `suppa_use_tenant`: Switch the active tenant (alias / host / URL)
- `suppa_validate_entity_code`: Run the schema gate over an app repo before calling entity code done
- `suppa_validate_select`: Check a select/filter payload against the entity without running it — names the field that does not resolve
- `suppa_version`: Running build vs newest published, and how to upgrade

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
