convez.ai
MCP ServerIntegração & APIsIntermediário
fil-technology

AppMate MCP Server

fil-technology/appmate-mcp

Controle AppMate via Claude com typed tools e draft/publish workflows

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra Claude, Cursor e outros clientes com a plataforma AppMate, permitindo gerenciar aplicações, fluxos de cancelamento, waitlists, feedback e programas de referência sem sair do chat. Oferece ferramentas tipadas para listar apps, editar configurações de fluxos, publicar mudanças e exportar dados em CSV.

Instalação

$npx convez-ai fil-technology/appmate-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
v0.3.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerenciar configurações de waitlist, feedback e contato de apps diretamente no chat
  • Publicar alterações em fluxos de cancelamento e onboarding sem acessar dashboard
  • Exportar dados de waitlist e onboarding em CSV para análise

Veredito

MCP server bem estruturado com cobertura completa dos endpoints AppMate (apps, cancel flows, waitlists, feedback, reports, contact, onboarding, referral). Setup é simples (1 minuto com token) e a tipagem TypeScript garante confiabilidade. Ideal para quem constrói e opera apps na AppMate e quer automação via Claude.

README

A tradução para o português deste README ainda está na fila.

appmate-mcp

Model Context Protocol server for AppMate — lets Claude Desktop, Claude Code, Cursor, Codex, or any other MCP-aware client drive AppMate via typed tools. List apps, edit cancel flows, publish, export waitlists — without leaving the chat.

npx -y @fil-technology/appmate-mcp

Setup (1 minute)

  1. Issue a token at https://flow.appmate.cloud/admin/api-tokens. Copy the amk_… string — it's only shown once.
  2. Add the server to your MCP host's config (examples below).
  3. Restart the host and ask your agent: "list my appmate apps".

Claude Desktop / Claude Code

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (on macOS) or the equivalent on your platform:

{
  "mcpServers": {
    "appmate": {
      "command": "npx",
      "args": ["-y", "@fil-technology/appmate-mcp"],
      "env": {
        "APPMATE_TOKEN": "amk_…",
        "APPMATE_API_URL": "https://flow.appmate.cloud"
      }
    }
  }
}

Cursor / Codex (.mcp.json in your project)

{
  "mcpServers": {
    "appmate": {
      "command": "npx",
      "args": ["-y", "@fil-technology/appmate-mcp"],
      "env": { "APPMATE_TOKEN": "amk_…" }
    }
  }
}

APPMATE_API_URL defaults to https://flow.appmate.cloud. Override for staging or self-hosted instances.

Tools

ToolPurpose
list_appsList every app the token can see.
get_appFetch one app by id or slug.
create_appCreate a new app.
get_cancel_flowRead published + draft cancel config.
update_cancel_draftReplace the draft with new config JSON.
publish_cancel_flowPromote the draft live.
get_waitlist_flowRead published + draft waitlist config.
update_waitlist_draftReplace the waitlist draft.
publish_waitlist_flowPromote the waitlist draft live.
list_waitlist_signupsPaginated list (cursor + nextCursor).
export_waitlist_csvReturn the full waitlist as a CSV string.
get_feedback_flowRead published + draft feedback config.
update_feedback_draftReplace the feedback draft.
publish_feedback_flowPromote the feedback draft live.
list_feedback_submissionsPaginated list of feedback rows (rating + message + email).
get_report_flowRead published + draft report config.
update_report_draftReplace the report draft (categorised).
publish_report_flowPromote the report draft live.
list_report_submissionsPaginated, optional category filter.
get_contact_flowRead published + draft contact config.
update_contact_draftReplace the contact draft.
publish_contact_flowPromote the contact draft live.
list_contact_submissionsPaginated list of contact rows (name + email + message).
get_onboarding_flowRead published + draft onboarding (web-to-app funnel) config.
update_onboarding_draftReplace the onboarding draft (quiz / info / email-capture steps + handoff).
publish_onboarding_flowPromote the onboarding draft live.
list_onboarding_submissionsPaginated list of funnel completions (answers + email + claim status).
export_onboarding_csvReturn all onboarding completions as a CSV string.
get_referral_flowRead published + draft referral program config.
update_referral_draftReplace the referral draft (rewards, share text, cap, landing).
publish_referral_flowPromote the referral draft live.
list_referralsPaginated referral graph (status, source [link or typed-code], referee, reward flags).
export_referrals_csvReturn the full referral graph as a CSV string.
get_link_page_flowRead published + draft link-page (link-in-bio) config.
update_link_page_draftReplace the link-page draft (header, icon links, link list, theme).
publish_link_page_flowPromote the link-page draft live (appmate.cloud/p/{appSlug}).

Each referrer gets a unique link and a short, human-readable code (e.g. K7Q4-R9XP); a friend redeems by tapping the link or typing the code (no clipboard needed). source on each referral row records which path was used.

Tools that accept an app reference (get_app, update_cancel_draft, etc.) accept either the cuid id or the human-readable slug — use whichever you have. The full REST shape is documented at https://docs.appmate.cloud/api-reference.

Example agent prompts

"Create an AppMate app called Ledgr with bundle id com.acme.ledgr, then publish a simple cancel flow that offers a 20% discount for the too_expensive reason."

"Export the waitlist for appmate-pro as CSV and save it to ~/Downloads/waitlist.csv."

"Build a 3-question onboarding funnel for ledgr that asks the user's goal, captures their email, and hands off to the App Store, then publish it."

"Compare the published and draft cancel configs for quakemate and tell me what changed."

Local development

pnpm install
pnpm dev    # tsx src/index.ts — talks MCP over stdio
pnpm build  # emits dist/index.js

Security

  • Tokens are bcrypt-hashed server-side and only shown once on creation.
  • Revoke from the dashboard the moment a token leaks.
  • All calls go over TLS to flow.appmate.cloud. No data sits on disk in the MCP process beyond what your MCP host logs.

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados