Accelerate AI Integration

accelerate/get-performance-summary

Retrieve aggregated performance metrics for blocks, posts, experiments, or the entire site. Returns views, unique visitors, engagement rate, and conversion metrics with optional time series data.

Input Schema

Example Request (MCP)

{
  "entity_type": "site",
  "date_range_preset": "7d",
  "granularity": "auto",
  "compare_to_previous": true
}

REST Equivalent

curl -X POST "https://example.com/wp-json/wp-abilities/v1/abilities/accelerate%2Fget-performance-summary/run" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic BASE64_CREDENTIALS" \
  -d '{"input": {"entity_type": "site", "date_range_preset": "7d"}}'

accelerate/list-active-experiments

List all currently running A/B tests with their variants, traffic allocation, and current performance metrics.

Input Schema

Example Request (MCP)

{
  "status": "running",
  "limit": 10
}

accelerate/get-audience-segments

List all defined audience segments with their targeting rules and optional size estimates.

Input Schema

Example Request (MCP)

{
  "include_estimates": true
}

accelerate/get-audience-fields

List all available targeting fields for audience creation including country, browser, device, referrer, and custom dimensions.

accelerate/get-top-content

Get the highest-performing content by views or conversions. Perfect for identifying what's working.

Input Schema

Example Request (MCP)

{
  "content_type": "post",
  "metric": "views",
  "date_range_preset": "30d",
  "limit": 10
}

accelerate/get-content-diff

Compare content performance between two time periods to identify trends and changes.

Input Schema

Example Request (MCP)

{
  "period_a": {"preset": "7d"},
  "period_b": {"preset": "previous_7d"}
}

accelerate/get-traffic-breakdown

Get traffic breakdown by country, browser, operating system, or referrer source.

Input Schema

Example Request (MCP)

{
  "dimension": "country",
  "date_range_preset": "30d",
  "limit": 10
}

accelerate/get-post-performance

Detailed performance metrics for a single post, page, or synced pattern. Returns views, visitors, conversions, velocity (momentum), and automatic period-over-period comparison. Also surfaces any active experiments on the content.

Input Schema

Example Request (MCP)

{
  "post_id": 42,
  "date_range_preset": "7d"
}

accelerate/get-taxonomy-performance

Analytics grouped by WordPress taxonomy — categories, tags, or custom taxonomies. Returns per-term views, conversions, and an underserved score that identifies high-demand, low-supply topics.

Input Schema

Example Request (MCP)

{
  "taxonomy": "category",
  "date_range_preset": "30d",
  "limit": 20
}

accelerate/get-source-breakdown

Traffic source analysis with flexible grouping. Group by source (Google, Bing, Facebook, etc.), medium, campaign, or referrer domain to understand where your traffic comes from.

Input Schema

Example Request (MCP)

{
  "group_by": "source",
  "date_range_preset": "30d",
  "limit": 20
}

accelerate/get-utm-performance

UTM parameter performance metrics. Analyze how your marketing campaigns are performing by grouping traffic by campaign, source, medium, term, or content UTM parameters.

Input Schema

Example Request (MCP)

{
  "group_by": "campaign",
  "date_range_preset": "30d"
}

accelerate/get-landing-pages

Entry page analysis showing which pages visitors land on first. Returns bounce rate, average time on page, session depth, and conversion rate for each landing page.

Input Schema

Example Request (MCP)

{
  "date_range_preset": "30d",
  "limit": 20
}

accelerate/get-attribution-comparison

Compare first-touch vs last-touch attribution models to understand which channels introduce visitors versus which channels close conversions. Includes insights on best introducer, best closer, and most undervalued channel.

Input Schema

Example Request (MCP)

{
  "date_range_preset": "30d"
}

accelerate/get-trending-content

Content ranked by current momentum and velocity. Compares the current time window to the previous window to identify what's rising, stable, or falling in popularity.

Input Schema

Example Request (MCP)

{
  "window": "1h",
  "metric": "views",
  "content_type": "post",
  "limit": 10
}

accelerate/get-concurrent-visitors

Real-time concurrent visitor count. Shows how many unique visitors are currently active on your site or a specific post, with comparison to the same time yesterday. Optionally includes device and source breakdown.

Input Schema

Example Request (MCP)

{
  "active_window_minutes": 5,
  "include_breakdown": true
}

accelerate/get-author-performance

Performance metrics for a specific author or compare all authors. Returns post count, total views, visitors, conversions, conversion rate, average views per post, and top post for each author.

Input Schema

Example Request (MCP)

{
  "date_range_preset": "30d",
  "order_by": "views",
  "limit": 10
}

accelerate/get-author-content

All content by a specific author with per-post performance metrics. Returns views, visitors, conversions, and velocity (momentum trend) for each post.

Input Schema

Example Request (MCP)

{
  "author_id": 5,
  "date_range_preset": "30d",
  "order_by": "views"
}

accelerate/get-engagement-metrics

Quality engagement metrics beyond simple view counts. Returns average time on page, bounce rate, pages per session, recirculation rate, return visitor rate, scroll depth percentiles, and exit pages.

Input Schema

Example Request (MCP)

{
  "entity_type": "site",
  "date_range_preset": "30d"
}

accelerate/get-experiment-results

Detailed statistical results for running or completed experiments. Returns per-variant impressions, conversions, conversion rate, p-value, probability to beat control, and an AI recommendation (continue, declare winner, no winner, etc.).

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "refresh": true
}

accelerate/get-variants

Inspect all variants in a synced pattern. Returns each variant's title, content preview, raw markup, inner block types, percentage, audience, and fallback status. Also shows experiment state if one is running.

Input Schema

Example Request (MCP)

{
  "block_id": 456
}

accelerate/get-site-context

Returns your site's design system — color palette, typography, spacing, and optionally registered block types — so AI agents can create brand-consistent content. Uses theme.json data from your WordPress installation.

Input Schema

Example Request (MCP)

{
  "include_blocks": false
}

accelerate/search-content

Find WordPress content by title, URL, or text content. Returns matching posts with their ID, title, URL, type, and excerpt — useful for looking up content before running analytics or creating experiments.

Input Schema

Example Request (MCP)

{
  "query": "pricing",
  "search_in": "title",
  "post_type": "page",
  "limit": 10
}

accelerate/create-ab-test

Create a new A/B test with specified variants, traffic allocation, and goals.

Input Schema

Example Request (MCP)

{
  "name": "Homepage Hero Test",
  "block_id": 456,
  "variants": [
    {"name": "Control", "weight": 50},
    {"name": "New Headline", "weight": 50}
  ],
  "goal": "conversion"
}

accelerate/create-audience

Create a new audience with specified targeting rules for geographic, behavioral, or referral-based segmentation.

Input Schema

Example Request (MCP)

{
  "name": "US Visitors",
  "rules": [
    {
      "field": "location.country",
      "operator": "equals",
      "value": "US"
    }
  ]
}

accelerate/create-personalization-rule

Create a personalization rule that shows specific content to a target audience.

Input Schema

Example Request (MCP)

{
  "name": "Enterprise Pricing",
  "audience_id": 45,
  "block_id": 789,
  "variant_id": 2
}

accelerate/broadcast-content

Broadcast a block to multiple locations across the site. This is a destructive action requiring admin permissions. Available via REST API only — not exposed in MCP tool discovery.

Input Schema

Example Request (MCP)

{
  "block_id": 123,
  "target_locations": ["post"],
  "position": "before_content"
}

accelerate/update-audience

Modify an existing audience's targeting rules or settings.

Input Schema

Example Request (MCP)

{
  "audience_id": 45,
  "name": "North America Visitors",
  "rules": [
    {"field": "location.country", "operator": "in", "value": ["US", "CA"]}
  ]
}

accelerate/set-block-goal

Set the conversion goal for a block to track engagement, clicks, or form submissions.

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "goal": "form_submission"
}

accelerate/set-traffic-percentage

Adjust the traffic allocation percentage for an A/B test experiment.

Input Schema

Example Request (MCP)

{
  "experiment_id": 123,
  "percentage": 50
}

accelerate/add-variant

Append a new variant to an existing synced pattern. Accepts block markup or plain text (plain text is automatically wrapped in paragraph blocks). Optionally assign a title, traffic percentage, or audience.

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "content": "<!-- wp:heading --><h2>New Headline</h2><!-- /wp:heading -->",
  "title": "Bold Headline Variant",
  "percentage": 50
}

accelerate/update-variant

Update an existing variant's content and/or attributes. Provide at least one field to update — content, title, percentage, or audience. Variant index is zero-based.

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "variant_index": 1,
  "content": "<!-- wp:paragraph --><p>Updated content</p><!-- /wp:paragraph -->",
  "title": "Updated Variant"
}

accelerate/remove-variant

Remove a variant from a synced pattern by index. Cannot remove the last remaining variant. This is a destructive action that requires confirmation.

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "variant_index": 2
}

accelerate/stop-experiment

End, pause, resume, or declare a winner for an experiment. When declaring a winner, specify the winning variant index. This is a destructive action that requires confirmation.

Input Schema

Example Request (MCP)

{
  "block_id": 456,
  "action": "declare_winner",
  "winner_variant_index": 0
}

accelerate/query-events

Run raw event queries with custom filters and field selection. Supports operators like eq, neq, contains, gt, lt, and in for flexible filtering. Returns matching events with total count and query execution time.

Input Schema

Example Request (MCP)

{
  "filters": [
    {"field": "event_type", "operator": "eq", "value": "conversion"},
    {"field": "endpoint_demographic_platform", "operator": "contains", "value": "Android"}
  ],
  "date_range_preset": "7d",
  "limit": 100
}

accelerate/get-event-schema

Discover all available analytics event fields with their types, descriptions, and example values. Use this to understand what data is available before running queries or aggregations.

Input Schema

Example Request (MCP)

{
  "refresh": false
}

accelerate/aggregate

Run custom aggregations with flexible dimensions and metrics. Group data by any event field and apply aggregation functions: count, countDistinct, sum, avg, min, max. Perfect for building custom reports.

Input Schema

Example Request (MCP)

{
  "dimensions": ["endpoint_location_country"],
  "metrics": [
    {"field": "endpoint_id", "function": "countDistinct"},
    {"field": "event_type", "function": "count"}
  ],
  "date_range_preset": "30d",
  "limit": 20
}

accelerate/export-events

Export raw event data for external analysis. Supports filtering by date range, event type, and custom attributes.

Input Schema

Example Request (MCP)

{
  "event_types": ["conversion"],
  "date_range_preset": "30d",
  "format": "json"
}

accelerate/get-export-status

Check the status of an export job or verify if export data is available for a specific date range.

Input Schema

Example Request (MCP)

{
  "export_id": "abc123"
}