Server definition

Hash: sha256:7681fb46f188f0c2f04ebbfdae67df55d02e6af3536a1fcd27161d6e737194c6
What it is: What a remote MCP server returned when asked what it offers: 38 tools

The blob, as servednamed by its sha256

{
  "instructions": "PinAppAI exposes guided workflows as MCP prompts. If this client does not surface them, call pinappai_get_workflow and follow the returned procedure verbatim rather than improvising.",
  "tools": [
    {
      "description": "Server-side deterministic groupings (by selector / page / reviewer / keyword) plus heuristic suggested_clusters of change requests. Set ai_clusters=\"auto\" (default) to also request semantic clustering via the host's MCP sampling capability — returns ai_clustering_hint for the host AI to apply inline if sampling is unsupported. Use this BEFORE drilling into individual CRs to find patterns across the dataset.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "ai_clusters": {
            "description": "Controls semantic clustering via the host's MCP sampling capability. off skips it and returns only the deterministic groupings. auto (default) attempts it and falls back to an ai_clustering_hint for the calling AI to apply inline if the host doesn't support sampling. on requires sampling support and returns a sampling_unsupported error if the host doesn't provide it.",
            "enum": [
              "off",
              "auto",
              "on"
            ],
            "type": "string"
          },
          "ai_model_preference": {
            "description": "Optional model preference hint for the sampling request. Currently accepted but not forwarded to the host's createMessage call (the sampling request always uses a fixed speed/intelligence preference); reserved for future use.",
            "type": "string"
          },
          "group_by": {
            "description": "Which deterministic groupings to compute: selector (by CSS selector), page (by page URL), reviewer (by reviewer). Defaults to ['selector', 'page']. Keyword extraction (common_keywords) is always computed regardless of this setting.",
            "items": {
              "enum": [
                "selector",
                "page",
                "reviewer",
                "keyword"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "include": {
            "description": "Which feedback kinds to pull into the analysis: change_requested (a decision requesting a change), rejected (a decision rejecting the pick), approved (a decision approving the pick), comment (a comment-only pin, no decision). Defaults to ['change_requested'].",
            "items": {
              "enum": [
                "change_requested",
                "rejected",
                "approved",
                "comment"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "analyze_patterns",
      "outputSchema": null
    },
    {
      "description": "Soft-archive a project — the widget stops accepting new feedback but the project + history is preserved. Reversible via unarchive_project. Owner role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug to archive.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "archive_project",
      "outputSchema": null
    },
    {
      "description": "Create a new PinAppAI project inside the API key's workspace. Returns the project plus its widget api_key for embedding. Requires editor role on the workspace.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "allowed_origins": {
            "description": "Origins where the widget will load (e.g. https://example.com or *.example.com). Up to 20 entries.",
            "items": {
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "type": "array"
          },
          "name": {
            "description": "Human-readable project name.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "description": "Project slug (lowercase, hyphens). Must be unique across all PinAppAI projects.",
            "maxLength": 64,
            "minLength": 2,
            "pattern": "^[a-z0-9][a-z0-9-]*$",
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "type": "object"
      },
      "name": "create_project",
      "outputSchema": null
    },
    {
      "description": "Create a new workspace owned by the API key's user. Free/Pro plans cap at 1 workspace; Team/Business unlimited. To use the new workspace from MCP, mint a fresh key for it in the admin UI.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "Human-readable workspace name.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "description": "Workspace slug (lowercase, hyphens). Globally unique.",
            "maxLength": 64,
            "minLength": 2,
            "pattern": "^[a-z0-9][a-z0-9-]*$",
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "type": "object"
      },
      "name": "create_workspace",
      "outputSchema": null
    },
    {
      "description": "Schedule the API key's workspace for permanent deletion (7-day grace window). Reversible only via the email magic-link sent to the owner. Subsequent MCP calls with this key will fail not_found until cancelled.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "delete_workspace",
      "outputSchema": null
    },
    {
      "description": "GDPR Art. 15 right-of-access export — every row PinAppAI holds about the API key's user. Sensitive columns (password hash, OAuth tokens) are server-side redacted. Personal data of OTHER reviewers is NOT included.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "export_my_data",
      "outputSchema": null
    },
    {
      "description": "Get a single API key's metadata by id (no plaintext / hash). Owner or admin role required. Wrong-role and nonexistent-id both surface as not_found.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The api_keys.id (from list_api_keys).",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "get_api_key",
      "outputSchema": null
    },
    {
      "description": "Full detail for one change request. Returns the CR (including element_kind=text|mixed|field|null and suggested_text — a literal text-replacement the reviewer typed when picking a text/field element), plus related[] (other CRs on the same selector + same page) so you can detect patterns from a single fetch. Set include_image=true to embed the screenshot inline as an MCP image content block. When suggested_text is non-null on a text/field pick, paste it verbatim — do not interpret or rewrite. When element_kind=mixed, the element contains more than text (icons/images/structure) — rely on the comment + screenshot, not just the visible text.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The FEEDBACK id (fb_*), NOT a change-request id (cr_*). When you have a CR row from pinappai_list_apply_inbox / list_change_requests, pass its `source_feedback_id` (or just `id` in list_change_requests' response — same field) here. Passing a cr_* value returns 404.",
            "minLength": 1,
            "type": "string"
          },
          "include_image": {
            "description": "When true, also returns the change request's screenshot inline as an MCP image content block, in addition to the JSON text response. Defaults to false (JSON only).",
            "type": "boolean"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "id"
        ],
        "type": "object"
      },
      "name": "get_change_request",
      "outputSchema": null
    },
    {
      "description": "Whoami probe — returns the user behind the API key, the workspace it's bound to, the user's role in that workspace, and the API key's metadata. Run this first to establish context.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_me",
      "outputSchema": null
    },
    {
      "description": "Get a single project by slug — name, allowed_origins, archive state, and the embeddable widget api_key. Scoped to the API key's workspace.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "get_project",
      "outputSchema": null
    },
    {
      "description": "Cheap one-call summary of change-request state for a project. Returns totals + by-page + by-reviewer breakdowns + oldest/newest unresolved timestamps. Call this BEFORE drilling into individual CRs to frame the work.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "get_review_summary",
      "outputSchema": null
    },
    {
      "description": "Return the screenshot for a change request as an inline MCP image content block. Use when you want vision context without the full JSON envelope from get_change_request.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The FEEDBACK id (fb_*), NOT a change-request id (cr_*). When you have a CR row from pinappai_list_apply_inbox, pass its `source_feedback_id` here. Passing a cr_* value returns 404.",
            "minLength": 1,
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "id"
        ],
        "type": "object"
      },
      "name": "get_screenshot",
      "outputSchema": null
    },
    {
      "description": "Get the API key's workspace details (slug, name, plan, tier) plus the user's role in that workspace. Useful as a permissions probe.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_workspace",
      "outputSchema": null
    },
    {
      "description": "Invite a user to the API key's workspace as admin / editor / viewer (default editor). Admin role required to call. Sends a welcome email.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "description": "Invitee's email address.",
            "format": "email",
            "maxLength": 254,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "name": {
            "description": "Optional display name; defaults to the email's local-part.",
            "maxLength": 120,
            "type": "string"
          },
          "role": {
            "description": "Defaults to editor. Admins can't invite owners — that requires an existing owner.",
            "enum": [
              "admin",
              "editor",
              "viewer"
            ],
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "name": "invite_member",
      "outputSchema": null
    },
    {
      "description": "Invite an external reviewer to a project. They'll get a welcome email; status starts pending and flips to verified when they OTP through the widget. Editor role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "description": "Reviewer's email address.",
            "format": "email",
            "maxLength": 254,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "name": {
            "description": "Optional display name; defaults to the email's local-part.",
            "maxLength": 120,
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "email"
        ],
        "type": "object"
      },
      "name": "invite_reviewer",
      "outputSchema": null
    },
    {
      "description": "List API keys (active + recently-revoked) in the calling key's workspace. Plaintext / hash never returned. Owner or admin role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_api_keys",
      "outputSchema": null
    },
    {
      "description": "Read audit log entries for the API key's workspace. Owner role + Business tier required. Returns newest-first; supports filters action / actor (email substring) / from / to (Unix ms).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "description": "Exact dotted action name (e.g. \"feedback.update\", \"member.invite\").",
            "type": "string"
          },
          "actor": {
            "description": "Substring match on actor_email.",
            "type": "string"
          },
          "from": {
            "description": "Start of time range (Unix ms, inclusive).",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "limit": {
            "description": "Default 100, max 500.",
            "maximum": 500,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "description": "Default 0.",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "to": {
            "description": "End of time range (Unix ms, exclusive).",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_audit_events",
      "outputSchema": null
    },
    {
      "description": "List change requests for a project with filters + cursor pagination. Defaults to include=['change_requested'] (highest-signal subset). Returns digest fields per row (including element_kind=text|mixed|field|null and suggested_text — a literal text replacement on text/field picks); no inline images at this tier (token-cheap by design). Use get_change_request for full detail + screenshots.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "cursor": {
            "description": "Opaque pagination cursor from a previous response's next_cursor. Pass it to fetch the next page.",
            "type": "string"
          },
          "include": {
            "description": "Which feedback kinds to include: change_requested (a decision requesting a change), rejected (a decision rejecting the pick), approved (a decision approving the pick), comment (a comment-only pin, no decision). Defaults to ['change_requested'].",
            "items": {
              "enum": [
                "change_requested",
                "rejected",
                "approved",
                "comment"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "limit": {
            "description": "Max rows to return per page. Defaults to 50, maximum 200.",
            "maximum": 200,
            "minimum": 1,
            "type": "integer"
          },
          "page_url": {
            "description": "Filter to change requests captured on this exact page URL.",
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          },
          "reviewer": {
            "description": "Filter by reviewer name or email (matches either field).",
            "type": "string"
          },
          "since": {
            "description": "ISO 8601 timestamp. Only return change requests created after this time.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "list_change_requests",
      "outputSchema": null
    },
    {
      "description": "List members of the API key's workspace with their roles, sorted owner → admin → editor → viewer. The user_id field is the lookup key for update_member_role and remove_member.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_members",
      "outputSchema": null
    },
    {
      "description": "List PinAppAI projects this API key can access. Returns one entry per project in the key's workspace, with slug, name, derived domain, and created_at. Call this first to see what projects are available before drilling into specific ones.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_projects",
      "outputSchema": null
    },
    {
      "description": "List external reviewers on a project (people invited via invite_reviewer). Workspace members are implicitly authorized and not listed here. Status: pending / verified / revoked.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "list_reviewers",
      "outputSchema": null
    },
    {
      "description": "List all workspaces the API key's user is a member of, with role per workspace. The api-key remains bound to its original workspace — to operate on another, mint a new key for that workspace in the admin UI.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_workspaces",
      "outputSchema": null
    },
    {
      "description": "v3 atomic apply primitive. Takes a list of {cr_id, before_text, after_text} after the AI has edited source for each. Creates one iteration record (audit trail visible in the Project history page) and transitions every eligible CR from inbox_* state to 'in_review' atomically. Per-CR errors (CR not in eligible state, e.g. someone deferred it mid-session) are returned in the response without failing the whole batch. Editor role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "applies": {
            "description": "List of CRs to mark applied in one atomic batch.",
            "items": {
              "additionalProperties": false,
              "properties": {
                "after_text": {
                  "description": "The source-file content AFTER your edit.",
                  "maxLength": 4000,
                  "type": "string"
                },
                "before_text": {
                  "description": "The source-file content this CR targeted BEFORE you edited it. Stored on the cr_marked_applied event payload so admin Revert can swap byte-for-byte later. For 'inbox_rejected' CRs the AI should have already done the swap (after_text → before_text from the CR's previous cr_marked_applied event); the new before_text is the pre-revert source and after_text is the post-revert source.",
                  "maxLength": 4000,
                  "type": "string"
                },
                "cr_id": {
                  "description": "The change-request id (cr_*).",
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "cr_id",
                "before_text",
                "after_text"
              ],
              "type": "object"
            },
            "minItems": 1,
            "type": "array"
          },
          "bundle_summary": {
            "description": "Short human-readable summary of this Apply batch — shows up in the project history page. e.g. \"applied 7 CRs across 3 pages\".",
            "maxLength": 2000,
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "applies"
        ],
        "type": "object"
      },
      "name": "pinappai_apply_change_requests",
      "outputSchema": null
    },
    {
      "description": "Read coverage metrics for an iteration: items_decided / manifest_size + items_undecided + per-reviewer decided_count + disagreement_count. Useful for the AI to summarize \"you have N items still waiting on M reviewers\" and identify CRs needing admin attention. Read-only.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "iteration_id": {
            "description": "The iteration id (it_*).",
            "minLength": 1,
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "iteration_id"
        ],
        "type": "object"
      },
      "name": "pinappai_get_iteration_coverage",
      "outputSchema": null
    },
    {
      "description": "Return the full procedure for a PinAppAI guided workflow, rendered exactly as the\n/pinappai:<name> prompt delivers it. Call this when the user asks for one of these\nand this client does not surface MCP prompts. Follow the returned text verbatim and\ndo not improvise a workflow from its name or description.\n\nAvailable workflows:\n  analyze                Read-only pattern analysis of change requests\n  apply                  v3 PinAppAI Apply — drain the project Inbox by editing source for every Apply-eligible change…\n  audit-review           Pull recent audit-log events for the workspace and summarize unusual activity\n  auth-help              Walk through PinAppAI MCP authentication — recommend the browser-flow login first, fall back…\n  embed-widget           Embed the PinAppAI widget snippet into an EXISTING project's site, then bootstrap the…\n  generate-changes-page  Generate a temporary /changes/ review page for a multi-page rewrite\n  remove                 Remove ALL PinAppAI integration from this repository (widget script, /changes/ pages, optional…\n  reset-project          Reset a project's review data to zero — permanently delete its change requests, iterations,…\n  setup-project          Walk the user through creating a new PinAppAI project from scratch — pick or create a…\n  summarize              Generate a PR description / changelog / customer email from completed work, referencing the…",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The workflow to fetch. See the description for what each does.",
            "enum": [
              "analyze",
              "apply",
              "audit-review",
              "auth-help",
              "embed-widget",
              "generate-changes-page",
              "remove",
              "reset-project",
              "setup-project",
              "summarize"
            ],
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "pinappai_get_workflow",
      "outputSchema": null
    },
    {
      "description": "v3 Apply-inbox listing. Returns every change request in an Apply-eligible inbox substate (inbox_new / inbox_rejected / inbox_change_requested) with the prior cr_marked_applied event payload AND the latest reviewer/admin decision payload inlined per row. Used by /pinappai:apply to drive substate-specific edits (new = standard apply; rejected = revert via swap; change_requested = apply with new wording) in one round-trip.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Max rows to return (default 100).",
            "maximum": 500,
            "minimum": 1,
            "type": "integer"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "pinappai_list_apply_inbox",
      "outputSchema": null
    },
    {
      "description": "Paginated history of iterations for a project, newest first. Each entry includes seq_no, opened_at, applied_at (NULL while open), bundle_summary, and the frozen manifest_cr_ids_json + manifest_reviewer_ids_json. Pair with pinappai_get_iteration_coverage to summarize outcomes per iteration.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "before_seq": {
            "description": "Pagination cursor — return iterations with seq_no strictly less than this.",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "limit": {
            "description": "Max iterations to return (default 50, max 200).",
            "maximum": 200,
            "minimum": 1,
            "type": "integer"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "pinappai_list_iterations",
      "outputSchema": null
    },
    {
      "description": "Register the items of a freshly written /changes/ review page with the server — REQUIRED after generating or regenerating the page, or the in-page review chip and decision bars have no data. Pass every [data-pp-item] in document order with the same attribute values you put in the markup. This replaces the removed client-side self-registration: the page itself can no longer register anything. Editor role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "items": {
            "description": "Every [data-pp-item] on the page you just wrote, in DOCUMENT ORDER (order drives the review queue). The FULL active set — items you omit are deactivated server-side.",
            "items": {
              "additionalProperties": false,
              "properties": {
                "after_text": {
                  "description": "The AFTER text, verbatim from the page.",
                  "maxLength": 4000,
                  "type": "string"
                },
                "applied_cr_id": {
                  "description": "The originating CR id (data-pp-applied-cr-id). Items whose CR no longer exists are dropped server-side; omit only for hand-authored items.",
                  "maxLength": 64,
                  "minLength": 1,
                  "type": "string"
                },
                "before_text": {
                  "description": "The BEFORE text, verbatim from the page.",
                  "maxLength": 4000,
                  "type": "string"
                },
                "id": {
                  "description": "The data-pp-item value — e.g. \"pricing:hero-title\".",
                  "maxLength": 200,
                  "minLength": 1,
                  "type": "string"
                },
                "target_page_url": {
                  "description": "Root-relative URL of the ACTUAL page the change lives on (data-pp-page-url).",
                  "maxLength": 2048,
                  "type": "string"
                },
                "target_source_files": {
                  "description": "Comma-separated source-repo file paths (data-pp-source-files).",
                  "maxLength": 2048,
                  "type": "string"
                },
                "target_source_selector": {
                  "description": "CSS selector to the element on the source page (data-pp-source-selector).",
                  "maxLength": 2048,
                  "type": "string"
                },
                "title": {
                  "description": "The data-pp-title value.",
                  "maxLength": 300,
                  "type": "string"
                }
              },
              "required": [
                "id"
              ],
              "type": "object"
            },
            "maxItems": 2000,
            "minItems": 1,
            "type": "array"
          },
          "page_path": {
            "description": "Path of the /changes/ page on the site. Default '/changes'.",
            "maxLength": 2048,
            "minLength": 1,
            "pattern": "^\\/[\\w\\-./]*$",
            "type": "string"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "items"
        ],
        "type": "object"
      },
      "name": "pinappai_register_change_items",
      "outputSchema": null
    },
    {
      "description": "Permanently deletes a project's review data: all change requests (+ their event history), iterations, reviewer decisions, ALL freeform pins/comments with their screenshots, and the /changes/-page registration tables. NOT recoverable — no grace window. Requires admin role. Ask the user for explicit confirmation before calling, and prefer the /pinappai:reset-project prompt, which also offers to clean up the repo's static /changes/ page and .pinappai/last-applied.json.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "confirm": {
            "const": true,
            "description": "Must be literally true. The caller must have shown the user what will be deleted and received explicit confirmation first — there is no grace window; this is not recoverable.",
            "type": "boolean"
          },
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "confirm"
        ],
        "type": "object"
      },
      "name": "pinappai_reset_review_data",
      "outputSchema": null
    },
    {
      "description": "Remove a member from the API key's workspace. Self-removal works for any role; cross-removal requires admin+ and outranking the target. Last-owner removal returns last_owner.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "user_id": {
            "description": "The member's user_id (from list_members).",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "user_id"
        ],
        "type": "object"
      },
      "name": "remove_member",
      "outputSchema": null
    },
    {
      "description": "Restore a soft-revoked API key (within 7 days of revocation). Owner or admin role required. Returns restore_window_expired if the row was never revoked or was revoked > 7 days ago.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The api_keys.id to restore.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "restore_api_key",
      "outputSchema": null
    },
    {
      "description": "Soft-revoke an API key (reversible via restore_api_key for 7 days). Owner or admin role required. Refuses to revoke the calling key with cannot_revoke_self.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The api_keys.id to revoke.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "name": "revoke_api_key",
      "outputSchema": null
    },
    {
      "description": "Revoke an external reviewer's access. First call soft-revokes (status=revoked, audit trail preserved); second call hard-deletes (status=removed). Editor role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug.",
            "minLength": 1,
            "type": "string"
          },
          "reviewer_id": {
            "description": "The project_reviewers row id (from list_reviewers).",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project",
          "reviewer_id"
        ],
        "type": "object"
      },
      "name": "revoke_reviewer",
      "outputSchema": null
    },
    {
      "description": "Restore an archived project — the widget starts accepting feedback again on pages that still embed the snippet. Owner role required.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "The project slug to unarchive.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "unarchive_project",
      "outputSchema": null
    },
    {
      "description": "Update the API key user's display name. Email is identity and not editable.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "The new display name.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "update_me_profile",
      "outputSchema": null
    },
    {
      "description": "Change a workspace member's role. Caller must outrank both the current role and the new role; promoting to owner requires owner role. Last-owner demotion is rejected with last_owner.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "role": {
            "description": "The new role.",
            "enum": [
              "owner",
              "admin",
              "editor",
              "viewer"
            ],
            "type": "string"
          },
          "user_id": {
            "description": "The member's user_id (from list_members).",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "user_id",
          "role"
        ],
        "type": "object"
      },
      "name": "update_member_role",
      "outputSchema": null
    },
    {
      "description": "Update editable fields on a project — slug, name, owner_email, allowed_origins, allow_anonymous_reviewers, primary_origin (review link), preview_origin (preview review link). Requires editor role.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "allow_anonymous_reviewers": {
            "description": "When true, any verified email on a CORS-allowed origin can submit feedback. When false, the email must be on the workspace or project_reviewers list.",
            "type": "boolean"
          },
          "allowed_origins": {
            "description": "REPLACES the existing list. Pass an empty array [] to clear all allowed origins.",
            "items": {
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 20,
            "type": "array"
          },
          "name": {
            "description": "New display name for the project.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "owner_email": {
            "description": "Reassign project ownership to a different email (for display only — does not change permissions).",
            "format": "email",
            "maxLength": 254,
            "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "preview_origin": {
            "anyOf": [
              {
                "format": "uri",
                "maxLength": 255,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional branch/preview deploy origin. review.pinappai.com/p/<slug>~preview/ serves it so reviewers can check APPLIED changes before they ship — records still write against primary_origin. Set this after publishing an apply round to a preview deploy; null (or an empty string) clears it."
          },
          "primary_origin": {
            "anyOf": [
              {
                "format": "uri",
                "maxLength": 255,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Canonical site origin powering the no-install review link (review.pinappai.com/p/<slug>/). Any URL is normalized down to its origin. null (or an empty string) clears it and disables the link."
          },
          "project": {
            "description": "Current project slug (the lookup key).",
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "description": "New slug (renames the project; widget snippets keep working since they reference api_key, not slug).",
            "maxLength": 64,
            "minLength": 2,
            "pattern": "^[a-z0-9][a-z0-9-]*$",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "update_project",
      "outputSchema": null
    },
    {
      "description": "Rename or re-slug the API key's workspace. Owner role required. Slug changes break existing dashboard URLs.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "New display name for the workspace.",
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "slug": {
            "description": "Renaming slug breaks every URL pointing at the old slug — use sparingly.",
            "maxLength": 64,
            "minLength": 2,
            "pattern": "^[a-z0-9][a-z0-9-]*$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "update_workspace",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:7681fb46f188f0c2f04ebbfdae67df55d02e6af3536a1fcd27161d6e737194c6 | sha256sum