Skip to Content
AI Agents (MCP)Overview

AI agents (MCP)

Appneck runs an MCP  server, so an AI agent (Claude, Cursor, VS Code, n8n or your own script) can answer questions about your organization with live Appneck data, such as “why are users uninstalling plugin X this month?”.

  • Read-only. Agents can look; they can’t change anything in Appneck. This is enforced by the database, not just promised.
  • Your permissions, never more. A token works with the scopes you chose, and only while your role still allows them. If your role changes, the token loses access on its next call.
  • Short-lived and revocable. Every token expires (90 days by default, 365 at most), shows when and from which client it was last used, and can be revoked at once.
  • Personal data masked by default. Contact emails and names stay masked unless you give the token pii:read.

Endpoint

https://mcp.appneck.com/

Streamable HTTP. Send your token in the Authorization: Bearer header. Both the current MCP revision (2026-07-28) and 2025-era clients are supported.

Get started

  1. In the Appneck panel, open AI agents and create a token. Pick only the scopes the agent needs.
  2. Copy the token when it is shown: it is shown once.
  3. Follow the guide for your client under Connect a client.
  4. Ask the agent to call whoami first. It reports which organization the token reads and what it can see.

What’s available today:

  • whoami, your organization, plan usage and members, and your subscription and invoices.
  • Your products and analytics: install and uninstall trends, installation counts and lists, one site’s details, version and plugin breakdowns, uninstall survey results and responses, and announcements.
  • Licensing: plans, licenses with masked keys, and expiring licenses.
  • Email marketing: overview, lists, segments, contacts, campaigns and their reports, and workflows.
  • Demos: stats, blueprints, sites and leads.
  • search across everything your token can read.

See the tool reference. Two resources help an agent read the numbers: appneck://glossary says what each number means, and appneck://org/context gives your organization, timezone and products.

Four ready-made prompts appear in clients that support MCP prompts (in Claude Code, as /mcp__appneck__…):

  • weekly_product_health
  • uninstall_reason_analysis
  • campaign_performance_review
  • license_renewal_risk

The changelog lists changes as they ship.