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 (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 |
If you need programmatic access to dashboard-only metrics, contact support — additional API endpoints for these metrics are under consideration.
Availability by tier
The table below reflects the listing analytics API 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:
- Premium listing tier
- Transaction-capable MCP server (bookings, orders, or purchases)
- Referral token integration (automatic for Ready servers)
