# Conviva

> Conviva is the streaming-media and digital-experience analytics company behind Experience-Centric
> Operations (ECO) — a real-time, full-census operational data platform that stitches client-side
> telemetry from its Sensor SDKs into stateful, per-viewer experience analytics for video streamers,
> broadcasters and app publishers. Its Pulse portal is fronted by a public REST API at
> api.conviva.com and by two hosted, OAuth-protected Model Context Protocol servers.

Generated by the API Evangelist enrichment pipeline on 2026-08-01. Conviva serves no /llms.txt of
its own (docs.conviva.ai/llms.txt returns 404), so this file is generated from the catalog entry and
the artifacts in this repository. Everything below was verified live on 2026-08-01.

Key facts an agent should know before calling Conviva:

- **Authentication is HTTP Basic with an API key pair**, not a bearer token. Generate a `client-Id`
  and `client-secret` on the Pulse API Management page and send
  `Authorization: Basic base64(client_id:client_secret)`. Pulse *user* credentials will NOT work.
- **Everything is scoped to a c3 account.** Credentials, rate limits and data access all hang off it.
- **There is no OpenAPI.** Conviva's own APIs page says the Scalar/OpenAPI references "are being
  wired up separately" and the interactive reference "renders a placeholder until specs exist."
- **There is no pagination and no idempotency key.** Result sets are capped (max 500) and the
  documented remedy for exceeding a cap is to split the query time range into smaller intervals.
- **A time range is mandatory** since the 2024-03-27 release; there is no longer a default window.
- **Rate limits are concurrent-requests-per-minute per c3 account and are NOT signalled in headers**,
  so a client must self-throttle. 3000 requests / 5 minutes per IP is the global ceiling.
- **The agent surface is read-only.** Every write Conviva exposes over REST (filters, Precision
  policy, PII opt-out) is deliberately absent from its MCP servers.

## APIs

- [Metrics V3 API](https://docs.conviva.ai/api/apis/conviva-vsi-api/metrics-v3-api-guide/): Historical and real-time experience metrics. Base `https://api.conviva.com/insights/3.0/metrics` (historical, max 90 days, default granularity PT1H) and `https://api.conviva.com/insights/3.0/real-time-metrics` (max 15 minutes, default PT1M). Supports group-by dimensions, saved `filter_id` or `geo_*`/`device_*`/`tag_*` dimensional filters, `kpi_id` thresholds, `sort_by`/`order`, and `metric` selection (max 12 per custom-selection request). Responses cap at 5,700,000 bytes — past that you get HTTP 413.
- [Sessions V3 API](https://docs.conviva.ai/api/apis/conviva-vsi-api/sessions-v3-api/): Content and ad session detail plus per-viewer diagnostics. Base `https://api.conviva.com/insights/3.0/sessions`, with `/content`, `/ad`, `/content/viewer` and `/ad/viewer`. Max 500 sessions per response; use `?limit={N}`. Includes IPv4/IPv6 in `network_info`.
- [AI Alerts API](https://docs.conviva.ai/api/apis/conviva-vsi-api/ai-alerts-api-guide/): AI-detected content and ad alerts with diagnostics and impacted sessions. Base `https://api.conviva.com/insights/2.6/ai-alerts`, with `/content-metrics`, `/ad-metrics` and per-alert `/{alert_id}`. Filterable by time range and severity.
- [Bulk Filters API](https://docs.conviva.ai/api/apis/conviva-vsi-api/bulk-filter-api/): Bulk create/read/update/delete of saved filters at `https://api.conviva.com/bulk_filters`. Max 100 filters per call.
- [Precision Policy API](https://docs.conviva.ai/api/apis/conviva-vsi-api/precision-policy-api/): Retrieve, activate and reorder Precision policies at `https://api.conviva.com/precision/v1.0/policies`. POST operations require credentials created by a Precision Admin or you get HTTP 403. Limited to 40 concurrent requests/minute and 160 requests/hour.
- [PII Opt-Out API](https://docs.conviva.ai/api/apis/conviva-vsi-api/pii-opt-out-api/): Submit and check viewer PII deletion/opt-out requests at `https://api.conviva.com/pii-opt-out`, for GDPR/CCPA data-subject workflows.
- [Validation Timeline API v2](https://docs.conviva.ai/api/apis/conviva-vsi-api/validation-timeline-api-v2/): Session validation timeline for sensor-integration QA at `https://api.conviva.com/validation/v2/timeline`, queried by `viewer_id` and/or `session_id`.

## MCP servers

- [Conviva MCP Server](https://docs.conviva.ai/connect-data/mcp/): `https://mcp.conviva.com/mcp` (v1.0.0). Five sub-services — `/vsi/metrics`, `/vsi/ai-alerts`, `/vsi/sessions`, `/dpi/metrics`, `/dpi/ai-alerts`. OAuth 2.1 (authorization_code + PKCE S256 + dynamic client registration) or HTTP Basic with a Pulse API key for autonomous agents.
- [Conviva DPI MCP Server](https://github.com/Conviva/mcp-marketplace): `https://dpi-mcp.conviva.com/mcp` (v1.1.0). Five sub-services — `/insights`, `/nexa`, `/context-center`, `/session-replay`, `/metric-query`. Okta-backed OAuth 2.1. Installable in Claude Code with `/plugin marketplace add Conviva/mcp-marketplace` then `/plugin install conviva-dpi-mcp@conviva`.

Published MCP tools (names from Conviva's own Agent Skills; input schemas require an authenticated
`tools/list`): `identity-c3-account-list`, `context-center-nexa-semantic-search`,
`context-center-nexa-categories-list`, `context-center-nexa-knowledge-get`,
`context-center-asset-get`, `context-center-asset-list`, `metric-query-run`, `nexa-analyze`,
`nexa-analyze-result`, `insights-behavior-segment-list`, `insights-behavior-segment-get`.

## Agent skills

Conviva publishes three of its own Agent Skills for the DPI MCP server, mirrored verbatim in this
repository:

- [exploring-context-center](skills/conviva-exploring-context-center.md): Find Context Center assets by meaning, then hydrate the structured definition. Search the knowledge layer first, then fetch the asset.
- [querying-predefined-metrics](skills/conviva-querying-predefined-metrics.md): Run a predefined Context Center metric by `m_*` id over a date range, optionally broken down by `dimension_*` ids. Ids only — never raw SQL.
- [retrieving-behavior-segment-details](skills/conviva-retrieving-behavior-segment-details.md): Retrieve and interpret a stored Insights behavior segment's pre-computed insights, evidence and conversion barriers.

## Events

- [Alert webhooks](asyncapi/conviva-alerts-webhooks.yml): Outbound HTTPS POST for AI Alerts and Manual Alerts, with optional basic/token/custom-header auth, five retry attempts (immediate, 10s, 15s, 90s, 180s), and a documented 6–10 minute detection-to-delivery delay. No HMAC signing, no AsyncAPI document, no payload JSON Schema.
- [Conviva Connect](https://docs.conviva.ai/api/ssd/conviva-connect/eco-connect/): Session-summary data feeds delivered to S3, GCS, Snowflake, BigQuery or SFTP.

## Artifacts in this repository

- [apis.yml](apis.yml): APIs.json 0.20 catalog entry.
- [authentication/conviva-authentication.yml](authentication/conviva-authentication.yml): Full auth profile for REST and MCP.
- [scopes/conviva-scopes.yml](scopes/conviva-scopes.yml): OAuth scopes for the MCP servers (and why REST has none).
- [conventions/conviva-conventions.yml](conventions/conviva-conventions.yml): Pagination, time ranges, filtering, versioning, error envelope, rate-limit signalling.
- [errors/conviva-error-codes.yml](errors/conviva-error-codes.yml): Status-code catalog across all seven REST APIs.
- [rate-limits/conviva-rate-limits.yml](rate-limits/conviva-rate-limits.yml): Concurrency, payload and time-range limits.
- [lifecycle/conviva-lifecycle.yml](lifecycle/conviva-lifecycle.yml): Versioning, the deprecated V2 APIs, status page.
- [changelog/conviva-changelog.yml](changelog/conviva-changelog.yml): Dated API release notes.
- [packages/conviva-packages.yml](packages/conviva-packages.yml): The npm/Maven/CocoaPods/SPM sensor SDK estate.
- [mcp/conviva-mcp.yml](mcp/conviva-mcp.yml): Both MCP servers, their services and their OAuth metadata.
- [mcp/conviva-tool-crosswalk.yml](mcp/conviva-tool-crosswalk.yml): Where the MCP and REST surfaces diverge.
- [well-known/conviva-well-known.yml](well-known/conviva-well-known.yml): The `/.well-known/` probe results.
- [conformance/conviva-conformance.yml](conformance/conviva-conformance.yml): Standards Conviva does and does not meet.
- [security/conviva-trust-center.yml](security/conviva-trust-center.yml): ISO/IEC 27001:2022, GDPR, CCPA.
- [security/conviva-domain-security.yml](security/conviva-domain-security.yml): TLS/HSTS/SPF/DMARC probe.

## Docs

- [Developer tools](https://docs.conviva.ai/conviva-overview/developer-tools/)
- [APIs overview](https://docs.conviva.ai/connect-data/apis/)
- [What's new in Conviva APIs](https://docs.conviva.ai/api/whats-new-conviva-apis/)
- [API Management (generate credentials)](https://docs.conviva.ai/vsi-pages/api-mgt/api-management-4129047/)
- [MCP](https://docs.conviva.ai/connect-data/mcp/)
- [Data retention policy](https://docs.conviva.ai/common/a-common/retention-policy-2720465/)
- [Status page](https://status.conviva.com/)
- [Trust center](https://www.conviva.ai/security/)
- [Legal and privacy](https://legal.conviva.ai/)
- [GitHub organization](https://github.com/Conviva)

## Optional

- [Conviva blog](https://www.conviva.ai/blog/)
- [Get started](https://www.conviva.ai/get-started)
- [Pulse login](https://pulse.conviva.com/)
- Support: support@conviva.com · Privacy: privacy@conviva.ai