Skip to Content
AI Agents (MCP)Scopes reference

Scopes reference

A token can only use the scopes it was created with, and only while its creator’s role still allows them. Every scope maps to the permission that guards the same data in the Appneck panel, or a stricter one: an MCP token never sees more than its creator does in the panel.

Organization server (https://mcp.appneck.com/)

ScopeWhat it unlocksNeeds (any one of)
org:readOrganization profile: Organization name, plan, timezone, and plan usage.Any membership
members:readMembers and roles: Team members, their roles and whether 2FA is on.manage_members
billing:readPlan, subscription and invoices: Current plan, subscription status and invoices (no PDF links).manage_billing
products:readProducts: Products, versions and key metadata. Never secrets.Any membership
analytics:readAnalytics and installations: Install and usage series, installations, environments, survey results, announcements.view_analytics
licensing:readLicensing: License plans, licenses (keys always masked) and activations.manage_licenses
marketing:readEmail marketing: Contacts overview, lists, segments, campaigns and workflows with their reports.marketing.view
demos:readDemos and leads: Demo blueprints, demo sites, demo statistics and leads.manage_demos
pii:readInclude personal data: Shows emails and names of contacts, site admins, survey responders and leads instead of masking them, in every area this token can read. The data goes to the AI provider you connect.Any membership

Platform server (Appneck staff only)

ScopeWhat it unlocksNeeds (any one of)
platform.overview:readPlatform KPIs: Global KPIs across all organizations.view_global_analytics
platform.organizations:readOrganizations: Organization search and detail.manage_tenants, view_organizations
platform.subscriptions:readSubscriptions: Subscriptions by status, plan and renewal.manage_tenants, view_organizations
platform.revenue:readRevenue report: Revenue by month and plan.view_global_analytics
platform.licenses:readLicenses (all organizations): Licenses across organizations, keys masked.manage_licenses
platform.demos:readPlatform demos: Platform blueprints, demo sites, leads and demo host health.view_platform_demos
platform.system:readSystem status and alerts: System status checks and open alerts.view_system_status
platform.audit:readAudit log: Audit log search.view_audit_log
pii:readInclude personal data: Shows emails and names of contacts, site admins, survey responders and leads instead of masking them, in every area this token can read. The data goes to the AI provider you connect.Any staff member