{"id":"com.pinappai/mcp","slug":"com-pinappai-mcp","title":"PinAppAI","description":"Visual website feedback your coding agent applies: pin change requests on the live site over MCP.","version":"0.9.9","publisher":{"kind":"domain","id":"pinappai.com","label":"pinappai.com","url":"https://pinappai.com"},"website":"https://pinappai.com/docs/mcp/","repository":"","remotes":[{"type":"streamable-http","url":"https://mcp.pinappai.com/mcp","headers":[{"description":"Bearer ppk_... workspace API key. Omit for keyless discovery; required for tool calls.","format":"string","isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","identifier":"@pinappai/mcp","version":"0.9.9","transport":{"type":"stdio"},"environmentVariables":[{"description":"PinAppAI workspace API key (ppk_...). Optional: interactive setups use `npx @pinappai/mcp login` instead; set this only for CI/headless.","format":"string","isSecret":true,"name":"PINAPPAI_API_KEY"}]}],"published":"2026-07-25","updated":"2026-07-25","status":"online","auth":"","latency_ms":1162,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_projects","title":"","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.","read_only":true},{"name":"get_review_summary","title":"","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.","read_only":true},{"name":"list_change_requests","title":"","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.","read_only":true},{"name":"get_change_request","title":"","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 su","read_only":true},{"name":"analyze_patterns","title":"","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 th","read_only":true},{"name":"get_screenshot","title":"","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.","read_only":true},{"name":"get_project","title":"","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.","read_only":true},{"name":"create_project","title":"","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.","read_only":false},{"name":"update_project","title":"","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.","read_only":false},{"name":"archive_project","title":"","description":"Soft-archive a project — the widget stops accepting new feedback but the project + history is preserved. Reversible via unarchive_project. Owner role required.","read_only":false},{"name":"unarchive_project","title":"","description":"Restore an archived project — the widget starts accepting feedback again on pages that still embed the snippet. Owner role required.","read_only":false},{"name":"list_workspaces","title":"","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.","read_only":true},{"name":"create_workspace","title":"","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.","read_only":false},{"name":"get_workspace","title":"","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.","read_only":true},{"name":"update_workspace","title":"","description":"Rename or re-slug the API key's workspace. Owner role required. Slug changes break existing dashboard URLs.","read_only":false},{"name":"delete_workspace","title":"","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.","read_only":false},{"name":"list_members","title":"","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.","read_only":true},{"name":"invite_member","title":"","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.","read_only":false},{"name":"update_member_role","title":"","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.","read_only":false},{"name":"remove_member","title":"","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.","read_only":false},{"name":"list_reviewers","title":"","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.","read_only":true},{"name":"invite_reviewer","title":"","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.","read_only":false},{"name":"revoke_reviewer","title":"","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.","read_only":false},{"name":"list_audit_events","title":"","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).","read_only":true},{"name":"list_api_keys","title":"","description":"List API keys (active + recently-revoked) in the calling key's workspace. Plaintext / hash never returned. Owner or admin role required.","read_only":true},{"name":"get_api_key","title":"","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.","read_only":true},{"name":"revoke_api_key","title":"","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.","read_only":false},{"name":"restore_api_key","title":"","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.","read_only":false},{"name":"get_me","title":"","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.","read_only":true},{"name":"update_me_profile","title":"","description":"Update the API key user's display name. Email is identity and not editable.","read_only":false},{"name":"export_my_data","title":"","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.","read_only":true},{"name":"pinappai_get_iteration_coverage","title":"","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.","read_only":true},{"name":"pinappai_list_iterations","title":"","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.","read_only":true},{"name":"pinappai_list_apply_inbox","title":"","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 word","read_only":true},{"name":"pinappai_apply_change_requests","title":"","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 ","read_only":false},{"name":"pinappai_reset_review_data","title":"","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 clea","read_only":false},{"name":"pinappai_register_change_items","title":"","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. Edito","read_only":false},{"name":"pinappai_get_workflow","title":"Get PinAppAI workflow","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","read_only":true}],"server_info":{"name":"pinappai","title":"PinAppAI","version":"0.1.0"},"category":"project","tags":["agents","web-search","browser"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-25","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-pinappai-mcp/"}