Grona MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GRONA_API_KEY | No | Your Embed workspace secret from the Grona web app (Settings → Secrets). Required for network/API tools; local tools, resources and prompts work without credentials. | |
| GRONA_MOBILE_API_KEY | No | Your separate mobile grants secret, provisioned separately by Grona. Omit if you only use Embed. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Use grona://reference/agent-guide before changing campaigns. Create paused, edit and preview, then launch. Treat editor/preview links and grants as sensitive. This server acts within the configured workspace and does not authenticate individual shoppers. Mobile customerId must come from an authenticated backend session.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| grona_list_campaignsA | Return every workspace campaign with variations and previews. No upstream pagination or specified order; editor links are omitted. |
| grona_create_campaignB | Create a paused campaign and variations with 15-minute editor links. Use externalId for duplicate protection. Requires Embed snippet and page variable. Creation never publishes. |
| grona_get_campaignA | Get by opaque Grona id or workspace-unique externalId. Grona id wins on ambiguity. No editor links return. |
| grona_update_campaignA | Patch mutable fields; returns full campaign. url/type/pageTargeting are fixed at creation. Retry only by immutable Grona id. trafficSplit keys are variation ids totaling 100. |
| grona_delete_campaignA | Permanently delete campaign and unshared variations. Frees externalId for reuse. Retry only by immutable Grona id. Propagation to visitors is asynchronous. |
| grona_set_campaign_statusA | Set live or paused. live affects real visitors after propagation. Prefer grona_launch_campaign for readiness guards; this direct route has none. |
| grona_create_edit_linkA | Mint a secret 15-minute editor link by variationId (preferred) or page url. variationId wins; url chooses most recently updated match. Editor trust covers the workspace. Open immediately; do not store, log or share. |
| grona_validate_edit_linkA | Send the whole editor URL; receive original or refreshed link. Always open returned data.editUrl. valid=false/refreshed=true is successful. |
| grona_verify_scriptA | Check exact page for this workspace’s Embed snippet. absent also means inaccessible page. Does not verify execution, anti-flicker, consent, CSP or whole site. Can take several seconds. |
| grona_issue_grantsA | Fetch current signed grants from separate mobile service/credential. customerId must come from authenticated shopper session, never app input or PII. Return tokens unchanged; this does not verify or redeem them. |
| grona_search_campaignsA | Fetch full list once; filter locally by text/status/type/domain/script state/externalId and sort deterministically. offset/limit are local presentation controls. |
| grona_create_campaign_onceB | Require externalId; on 409 fetch and compare existing campaign identity before recovering with fresh editor links. Conflict never patches or publishes an existing campaign. |
| grona_campaign_overviewA | Read campaign and summarize targeting, previews, variation health and next steps. Does not mint editor links or claim analytics exist. |
| grona_check_campaign_readinessA | Read campaign and freshly verify its actual page from stored url or preview URL. Report observable blockers and manual checks. Cannot inspect saved edits or previews. |
| grona_launch_campaignA | Require edited=true and previewed=true attestations, freshly verify actual campaign page, then set live by immutable id. Refuse absent snippet/unusable variations. Direct tools remain unguarded. |
| grona_set_ab_splitA | Read A/B campaign; map Control/Test to current variation ids, validate integer percentages total 100, update by immutable campaign id. |
| grona_evaluate_page_targetingB | Locally evaluate URL rules and optional page-variable value. Multiple-page exclusions still require exact origin and segment count. Predicts eligibility, not execution or traffic allocation. |
| grona_generate_snippetA | Generate escaped Embed HTML and optional page-variable assignment. Dashboard snippet may include anti-flicker; this helper installs nothing. |
| grona_configurationA | Show credential-presence flags, hosts and timeout/retry settings without secrets. Makes no upstream request. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| grona_campaign_lifecycle | Guide a campaign through installation, editing, preview and launch. |
| grona_debug_installation | Diagnose absent Embed snippet on one page. |
| grona_mobile_integration | Secure mobile grants delivery and order-backend obligations. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| api-routes | All upstream operations and direct MCP equivalents. |
| agent-guide | Lifecycle, targeting, installation, editor-link and mobile guidance. |
| error-guide | Stable error codes and recovery rules. |
| openapi | Captured authoritative OpenAPI 3.1 contract. |
TDQS
Scored across 19 tools
Most tools have clearly distinct purposes, and the descriptions do unusually explicit boundary work (e.g. grona_launch_campaign vs grona_set_campaign_status, grona_verify_script vs grona_check_campaign_readiness). There are still overlapping read surfaces (list_campaigns / search_campaigns / get_campaign / campaign_overview) and two create paths, so a few pairs require reading descriptions carefully before selection.
All tools share a grona_ prefix plus snake_case verb_noun naming (create_campaign, set_campaign_status, validate_edit_link, evaluate_page_targeting), which is highly predictable. The only deviations are noun-only names like grona_configuration and grona_campaign_overview, which break the verb pattern slightly but remain readable.
At 19 tools the set sits at the heavy end for a campaign/experiment domain, with several near-siblings (two creates, four read variants, two status paths) that could arguably be consolidated. Each tool does have a defensible role, but the surface feels larger than the core workflow strictly requires.
Core lifecycle is well covered: create/get/update/delete/list/search, status and guarded launch, idempotent create, editor links, snippet generation and verification, A/B split, targeting evaluation, readiness and overview. The notable gap is results/analytics reading (explicitly out of scope) and no direct variation-content or variation-delete operation, though editor links provide a workaround.