List goals
List the goals set up in the site settings.
MCP tool plausible_read → list_goals
read
Returns each goal with its display name, trigger (pageview or custom_event) and the page path or event name it matches. It lists the goals as configured, whether or not anyone has converted yet. Use it before add_goal to avoid a duplicate.
Parameters
| Name | Type | Description |
|---|---|---|
| site string required | string | Domain of the site as the Sites page lists it, e.g. acme-shop.example. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "plausible_read",
"arguments": {
"operation": "list_goals",
"arguments": {
"site": "site"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"site": "acme-shop.example",
"goals": [
{
"name": "Checkout complete",
"trigger": "pageview",
"target": "/checkout/thank-you"
},
{
"name": "Newsletter signup",
"trigger": "custom_event",
"target": "Newsletter Signup"
}
]
},
"isError": false
}