MCP
MCP resources and prompts
Use Premely MCP resources and prompts for scoped analytics, conversion and workspace context.
What it is
MCP resources provide addressable Premely context, while prompts give compatible clients a safe structure for common analytics reviews.
Why use it
Use resources when a client needs a known data object and prompts when a user wants a repeatable evidence-based review.
Before you start
- Resources and prompts appear only when the token contains
mcp:useand every scope required by that item.
How to use it
- 1
List what the token can use
Call
resources/list,resources/templates/listorprompts/list. The result is already filtered by scope. - 2
Choose a URI or prompt
Use an exact
premely://URI or a listed prompt name. Do not construct a URI for another workspace. - 3
Supply bounded arguments
Historical analytics and review prompts require UTC ISO 8601 start and end timestamps.
- 4
Read the result as evidence
Preserve empty values, zero-conversion states and uncertainty. Do not infer a person or claim causation from aggregate metrics.
Resource catalog
| Resource or template | Scope | Returns |
|---|---|---|
premely://workspace/summary | usage:read | Workspace entitlement and current usage metadata. |
premely://sites/{site_id} | sites:read | Safe site configuration metadata. |
premely://sites/{site_id}/analytics/live{?minutes} | analytics:read | Aggregate live analytics for 1 to 30 minutes. |
premely://sites/{site_id}/analytics/historical{?start_at,end_at,granularity,include_suspicious} | analytics:read | Bounded historical overview and time series. |
premely://sites/{site_id}/goals | goals:read | Configured goals for the site. |
premely://sites/{site_id}/funnels | funnels:read | Configured funnels and ordered goal steps. |
premely://sites/{site_id}/exports | exports:read | Export job metadata without credentials or object keys. |
Prompt catalog
| Prompt | Scopes | Purpose |
|---|---|---|
premely_traffic_review | analytics:read | Review historical visitors, visits, pageviews, bounce rate and nullable visit duration. |
premely_live_health_review | analytics:read | Review a five-minute aggregate live traffic snapshot and state when data is empty or delayed. |
premely_conversion_review | goals:read + funnels:read + analytics:read | Review configured goals, funnels and aggregate conversion metrics without claiming causation. |
Supported MCP methods
| Method | Use |
|---|---|
server/discover | Negotiate the pinned protocol and read server capabilities. |
tools/list | List tools allowed by the token scopes. |
tools/call | Call one named Premely tool. |
resources/list | List concrete resources available to the token. |
resources/templates/list | List parameterized Premely resource templates. |
resources/read | Read one exact resource URI. |
prompts/list | List safe review prompts. |
prompts/get | Resolve one prompt with validated arguments. |
What to expect
Site data remains untrusted
Premely marks returned data as untrusted and never interprets a site label as an instruction.
Catalogs follow token scope
Revoking a token or removing a required scope removes access on the next request.