Groundhogg abilities, governed through the Bridge

An agent can search and manage contacts, tags, campaigns, and custom fields, read Groundhogg's own database tables and reports, build, activate, and simulate marketing flows (including one ability that really runs a flow against a live contact), and send or schedule broadcast and template emails.

Abilities
4723 read18 write6 destructive
Active installs
2K+
Rating
98% (149 ratings)
Version
4.8.3
Requires
WP 6.9+, PHP 7.4+
Last updated
2026-09-18 5:13pm GMT

What has to be true first

Needs WordPress 6.9 or later with Groundhogg active. Capability checks are per-ability, mostly Groundhogg's own custom capabilities (view_contacts, edit_contacts, add_contacts, view_funnels, edit_funnels, send_emails, view_broadcasts, schedule_broadcasts, manage_campaigns, manage_tags, view_reports, manage_gh_licenses), plus core WordPress capabilities upload_files, install_plugins, and manage_options for a few.

  • A paid Groundhogg add-on can register additional abilities at runtime through the public Abilities::add_ability() hook, so the exact list can grow beyond the 47 built into the free plugin

A note on the count below

47 abilities, not 46: the plugin's registration array (Abilities::register_abilities()) lists 47 ability classes, one more than a prior pass counted. Each id, capability, and readonly/destructive value below is read directly from that ability class's own NAME/CAPABILITY/READONLY/DESTRUCTIVE constants, or from the base class's explicit false/false defaults when a class does not override them.

The 47 Groundhogg abilities

Grouped by what each one can change. Every one starts off until you enable it.

Read 23

  • Read

    Get Broadcast

    Retrieve one broadcast by ID, including its full stats report.

    Permission
    view_broadcasts
    MCP tool
    aafm-bridge-groundhogg-get-broadcast
  • Read

    List Broadcasts

    List broadcasts, most recent first, with pagination.

    Permission
    view_broadcasts
    MCP tool
    aafm-bridge-groundhogg-list-broadcasts
  • Read

    List Campaigns

    List the campaigns defined in Groundhogg.

    Permission
    manage_campaigns
    MCP tool
    aafm-bridge-groundhogg-list-campaigns
  • Read

    Get Contact

    Retrieve a Groundhogg contact by ID.

    Permission
    view_contacts
    MCP tool
    aafm-bridge-groundhogg-get-contact
  • Read

    List Contact Notes

    List the notes on a contact, most recent first.

    Permission
    view_notes
    MCP tool
    aafm-bridge-groundhogg-list-contact-notes
  • Read

    List Custom Fields

    List the custom field definitions configured for contacts, including their group/tab, so raw contact meta keys (from groundhogg/get-contact or groundhogg/search-contacts with meta included) can be mapped to human-readable labels and types.

    Permission
    edit_contacts
    MCP tool
    aafm-bridge-groundhogg-list-custom-fields
  • Read

    List Owners

    List the WordPress users who can be assigned as a contact owner.

    Permission
    view_contacts
    MCP tool
    aafm-bridge-groundhogg-list-owners
  • Read

    List Saved Searches

    List the saved contact searches (Contacts > Saved Searches in the admin).

    Permission
    view_contacts
    MCP tool
    aafm-bridge-groundhogg-list-saved-searches
  • Read

    Search Contacts

    Search and list Groundhogg contacts, with pagination.

    Permission
    view_contacts
    MCP tool
    aafm-bridge-groundhogg-search-contacts
  • Read

    Describe Table

    List the tables groundhogg/query-table can query, or describe one table\

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-describe-table
  • Read

    Query Table

    Run a read-only, filtered query against one of Groundhogg\

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-query-table
  • Read

    Get Email Template

    Retrieve one saved Groundhogg email by ID, including its full HTML body and plain-text alternative.

    Permission
    view_emails
    MCP tool
    aafm-bridge-groundhogg-get-email-template
  • Read

    List Email Templates

    List saved Groundhogg emails, with pagination.

    Permission
    view_emails
    MCP tool
    aafm-bridge-groundhogg-list-email-templates
  • Read

    List Replacement Codes

    List the replacement codes (merge tags) available on this site, e.g.

    Permission
    view_emails
    MCP tool
    aafm-bridge-groundhogg-list-replacement-codes
  • Read

    List Sender Profiles

    List the valid "from" name / email combinations the site is configured to send as (the site default, one per contact owner, and any custom sender profiles).

    Permission
    send_emails
    MCP tool
    aafm-bridge-groundhogg-list-sender-profiles
  • Read

    List Extensions

    List Groundhogg\

    Permission
    manage_gh_licenses
    MCP tool
    aafm-bridge-groundhogg-list-extensions
  • Read

    List Flows

    List Groundhogg flows (funnels), most recently updated first.

    Permission
    view_funnels
    MCP tool
    aafm-bridge-groundhogg-list-flows
  • Read

    List Step Types

    List the flow/funnel step types available on this site (triggers, actions, and branching logic), with their settings shape.

    Permission
    view_funnels
    MCP tool
    aafm-bridge-groundhogg-list-step-types
  • Read

    Simulate Flow

    Trace what would happen to a real contact starting from a given step in a flow - which branches they'd take, roughly when timers would resolve - without enqueuing any real events or sending anything.

    Permission
    view_funnels
    MCP tool
    aafm-bridge-groundhogg-simulate-flow
  • Read

    Get Reports

    Pull data for one or more reports - built-in (see groundhogg/list-report-types\

    Permission
    view_reports
    MCP tool
    aafm-bridge-groundhogg-get-reports
  • Read

    List Report Types

    List the report IDs available to groundhogg/get-reports: built-in report ids, and the site\

    Permission
    view_reports
    MCP tool
    aafm-bridge-groundhogg-list-report-types
  • Read

    List Settings

    List Groundhogg settings available to abilities, each with its type, allowed values, description, and current value.

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-list-settings
  • Read

    List Tags

    List the tags defined in Groundhogg.

    Permission
    manage_tags
    MCP tool
    aafm-bridge-groundhogg-list-tags

Write 18

  • Write

    Associate Campaign

    Attach or detach a Groundhogg campaign from an existing flow, email, or broadcast.

    Permission
    manage_campaigns
    MCP tool
    aafm-bridge-groundhogg-associate-campaign
  • Write

    Create Campaign

    Create a new Groundhogg campaign.

    Permission
    manage_campaigns
    MCP tool
    aafm-bridge-groundhogg-create-campaign
  • Write

    Add Contact Note

    Add a note to a contact.

    Permission
    add_notes
    MCP tool
    aafm-bridge-groundhogg-add-contact-note
  • Write

    Add Custom Field

    Create a new contact custom field definition.

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-add-custom-field
  • Write

    Create Contact

    Create a new contact.

    Permission
    add_contacts
    MCP tool
    aafm-bridge-groundhogg-create-contact
  • Write

    Update Contact

    Update an existing contact by ID.

    Permission
    edit_contacts
    MCP tool
    aafm-bridge-groundhogg-update-contact
  • Write

    Update Custom Field

    Update an existing contact custom field definition by id.

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-update-custom-field
  • Write

    Create Email Template

    Create a new saved Groundhogg email (subject + HTML body).

    Permission
    add_emails
    MCP tool
    aafm-bridge-groundhogg-create-email-template
  • Write

    Update Email Template

    Update an existing saved Groundhogg email.

    Permission
    edit_emails
    MCP tool
    aafm-bridge-groundhogg-update-email-template
  • Write

    Activate License

    Activate a Groundhogg license key for this site.

    Permission
    manage_gh_licenses
    MCP tool
    aafm-bridge-groundhogg-activate-license
  • Write

    Check License

    Check the status of a Groundhogg license, or every registered license if none is given.

    Permission
    manage_gh_licenses
    MCP tool
    aafm-bridge-groundhogg-check-license
  • Write

    Install Extension

    Remotely install and activate one of Groundhogg\

    Permission
    install_pluginsAdministrators
    MCP tool
    aafm-bridge-groundhogg-install-extension
  • Write

    Activate Flow

    Activate a flow so contacts can start entering it and groundhogg/add-to-flow can enqueue contacts into it.

    Permission
    edit_funnels
    MCP tool
    aafm-bridge-groundhogg-activate-flow
  • Write

    Create Flow

    A local key for this step, unique within this call - e.g.

    Permission
    add_funnels
    MCP tool
    aafm-bridge-groundhogg-create-flow
  • Write

    Deactivate Flow

    Deactivate a flow, pausing its waiting events and stopping new contacts from entering via its triggers.

    Permission
    edit_funnels
    MCP tool
    aafm-bridge-groundhogg-deactivate-flow
  • Write

    Update Settings

    Update one or more Groundhogg settings by id.

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-groundhogg-update-settings
  • Write

    Create Tag

    Create a new Groundhogg tag.

    Permission
    add_tags
    MCP tool
    aafm-bridge-groundhogg-create-tag
  • Write

    Upload Media

    Upload a file (e.g.

    Permission
    upload_filesAuthors and up
    MCP tool
    aafm-bridge-groundhogg-upload-media

Destructive 6

  • Destructive

    Cancel Broadcast

    Cancel a scheduled or sending broadcast.

    Permission
    cancel_broadcasts
    MCP tool
    aafm-bridge-groundhogg-cancel-broadcast
  • Destructive

    Send Email Broadcast

    Schedule a one-off email broadcast to a segment of contacts (or send it now).

    Permission
    schedule_broadcasts
    MCP tool
    aafm-bridge-groundhogg-send-email-broadcast
  • Destructive

    Send Composed Email

    Send a one-off email with a subject and HTML body supplied directly (not a saved Groundhogg email).

    Permission
    send_emails
    MCP tool
    aafm-bridge-groundhogg-send-composed-email
  • Destructive

    Send Email Template

    Send an existing saved Groundhogg email to one or more contacts through the normal event queue.

    Permission
    send_emails
    MCP tool
    aafm-bridge-groundhogg-send-email-template
  • Destructive

    Add To Flow

    Add a contact, or a segment of contacts, to an active flow.

    Permission
    start_flows
    MCP tool
    aafm-bridge-groundhogg-add-to-flow
  • Destructive

    Live Simulate Flow

    Actually run a flow for a real contact starting from a given step - real events are created and real actions (send_email, apply_tag, ...) actually execute against the real contact.

    Permission
    edit_funnels
    MCP tool
    aafm-bridge-groundhogg-live-simulate-flow

How to switch these on

Four steps from two active plugins to a governed connection.

  1. Install Groundhogg and Agent Abilities for MCP

    Both plugins need to be active on the same WordPress site. Groundhogg registers its own abilities; this plugin discovers and governs them.

  2. Open the Other plugins screen

    In Agent Abilities for MCP, open the Bridge tab (labeled "Other plugins" in the admin). Abilities from every registered plugin appear there, grouped by the plugin that registered them.

  3. Enable one ability at a time

    Every ability from Groundhogg starts off. Turn on only the ones you want an agent to reach, or enable the whole set in one click.

  4. Connect as a least-privilege user

    Approve the connection as a WordPress account scoped to what you actually want the agent to do. Each call still re-checks that account’s capability before it runs.

Read more in how bridging works or the full documentation.

Frequently asked questions

Does Groundhogg work with the Bridge?

Yes. It registers 47 abilities with wp_register_ability through a shared base class that always sets an explicit readonly/destructive/idempotent annotation triple (defaulting both to false when a subclass does not override them), so the Bridge can discover and expose all of them, and any add-on can register more the same way via Abilities::add_ability().

What has to be true for Groundhogg's abilities to register?

A paid Groundhogg add-on can register additional abilities at runtime through the public Abilities::add_ability() hook, so the exact list can grow beyond the 47 built into the free plugin.

Does Groundhogg need anything special to work with the Bridge?

Needs WordPress 6.9 or later with Groundhogg active. Capability checks are per-ability, mostly Groundhogg's own custom capabilities (view_contacts, edit_contacts, add_contacts, view_funnels, edit_funnels, send_emails, view_broadcasts, schedule_broadcasts, manage_campaigns, manage_tags, view_reports, manage_gh_licenses), plus core WordPress capabilities upload_files, install_plugins, and manage_options for a few.

More Marketing plugins

An agent can generate a click-to-chat WhatsApp URL and read or update the configured phone number, call-to-action text, and pre-filled message, globally or for a specific post or term.

Marketing700K+ active installs
2 read3 destructive
View abilities

PixelYourSite

Conditional

An agent can audit which tracking pixels (Facebook, GA4, GTM, Bing, Pinterest, Reddit) are configured and healthy, read WooCommerce and Easy Digital Downloads event mappings, and, when the plugin's read-only toggle is off, create or update custom tracking events and automatic-event triggers.

Marketing400K+ active installs
10 read5 destructive
View abilities

NotificationX

Conditional

Once its MCP module is enabled, an agent can list, inspect, create, update, toggle, duplicate and delete FOMO/social-proof notifications, describe a notification type's valid sources and themes, and read form entries, analytics and plugin settings.

Marketing30K+ active installs
15 destructive
View abilities

Verified from Groundhogg's own free wordpress.org code on 28 September 2026, not from its marketing claims. Not every ability listed here has been run end to end against a live site. Plugin authors change their code, so a name, a capability, or a condition can be different in a later release. This site is not affiliated with, or endorsed by, Adrian Tobey or Groundhogg. Back to the full directory.

Back to the plugin directory

Bridge Groundhogg, keep the same control.

Every ability starts off, is scoped to the user you connect, and is written to the same audit log as core. Turn on only what you need.

Off by default. Capability checked on every call.