> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Track discovery, engagement, and conversion metrics for your Hub listing

## Overview

Hub Analytics shows how AI agents discover and interact with your listing — from search impressions to completed transactions.

## Metrics

Hub Analytics surfaces metrics through two channels: the **[listing analytics API](/hub/analytics-listings)** (queryable programmatically) and the **Hub Dashboard** (visual reporting). The tables below indicate which channel exposes each metric.

### Discovery

* **View count** — Total listing page views in the reporting period *(API + Dashboard)*
* **Search impressions** — How many times your listing appeared in search results *(API + Dashboard, Premium only)*
* **Click-throughs / Click-through rate** — How many agents selected your listing from results; views → click-through conversion *(API + Dashboard, Featured and Premium)*

### Engagement

* **Connections** — How many agents connected to your MCP server via Hub *(Dashboard only — not available via analytics API)*
* **Tool calls** — Which tools agents called and how often *(Dashboard only — not available via analytics API)*
* **Session duration** — How long agent sessions last *(Dashboard only — not available via analytics API)*

### Conversion

* **Referral clicks** — Referral-link interactions originating from Hub discovery *(API + Dashboard, Premium only)*
* **Conversion rate** — Transactions as a percentage of views *(API + Dashboard, Premium only)*
* **Action requests / Completion rate** — Bookings, orders, quotes submitted through agents and their completion rate *(Dashboard only — not available via analytics API)*

### Dashboard-only metrics (not in analytics API)

The following metrics appear in the Hub Dashboard but are **not** returned by the `GET /api/v1/hub/analytics/listings/:id` endpoint:

| Metric                            | Notes                                                                                |
| --------------------------------- | ------------------------------------------------------------------------------------ |
| Agent platform breakdown          | Dashboard visualization of which agent platforms drive traffic                       |
| Tool call analytics               | Per-tool call counts and patterns                                                    |
| Query pattern analysis            | Common search queries that surface your listing                                      |
| Competitive positioning           | Ranking context relative to similar listings                                         |
| CSV export                        | Dashboard export feature; API callers can build their own exports from API responses |
| Connections                       | MCP connection events                                                                |
| Session duration                  | Duration of agent sessions                                                           |
| Action requests / Completion rate | Transaction funnel depth beyond conversion rate                                      |

<Info>
  If you need programmatic access to dashboard-only metrics, contact support — additional API endpoints for these metrics are under consideration.
</Info>

## Availability by tier

The table below reflects the [listing analytics API](/hub/analytics-listings) response schema. Dashboard availability may differ.

| Metric                   | Basic | Featured | Premium | Source          |
| ------------------------ | ----- | -------- | ------- | --------------- |
| View count               | ✓     | ✓        | ✓       | API + Dashboard |
| Click-throughs           | —     | ✓        | ✓       | API + Dashboard |
| Click-through rate       | —     | ✓        | ✓       | API + Dashboard |
| Agent platform breakdown | —     | ✓        | ✓       | Dashboard only  |
| Search impressions       | —     | —        | ✓       | API + Dashboard |
| Referral clicks          | —     | —        | ✓       | API + Dashboard |
| Conversion rate          | —     | —        | ✓       | API + Dashboard |
| Tool call analytics      | —     | —        | ✓       | Dashboard only  |
| Query pattern analysis   | —     | —        | ✓       | Dashboard only  |
| Competitive positioning  | —     | —        | ✓       | Dashboard only  |
| CSV export               | —     | —        | ✓       | Dashboard only  |

## Referral commissions

Premium listings can earn referral commissions on transactions that originate from Hub discovery. When an AI agent finds your business through Hub and completes a transaction, the referral is tracked end-to-end.

Commission tracking requires:

1. Premium listing tier
2. Transaction-capable MCP server (bookings, orders, or purchases)
3. Referral token integration (automatic for Ready servers)