Integration Guide

Connect DiviDen to external services and protocols.

Google Integration

  • Email: Gmail sync with triage, label management, auto-drafting. OAuth scopes: gmail.readonly, gmail.compose, gmail.labels.

  • Calendar: Read/write access. View events in dashboard, create events via chat. OAuth scope: calendar.events.

  • Drive: Browse files, discuss documents with Divi. OAuth scope: drive.readonly.

  • Setup: Settings > Integrations > Connect Google. Standard OAuth 2.0 consent flow.

Webhook Configuration

  • Event types: queue.created, queue.completed, relay.received, agent.executed, contact.created, card.moved.

  • Payload format: JSON with event type, timestamp, data object, and signature.

  • HMAC verification: SHA-256 signature in X-DiviDen-Signature header. Verify against your webhook secret.

  • Setup: Settings > Webhooks > Add Endpoint. Test with the webhook tester.

MCP Server Setup

  • Model Context Protocol (MCP) v1.5 support for connecting external tools.

  • Register capabilities: declare tool schemas, parameter types, and return formats.

  • Server discovery: configure MCP endpoint URL in Settings > Integrations > MCP.

  • Tools appear as capabilities in Divi's action space automatically.

A2A Protocol

  • Agent-to-Agent communication for cross-platform task routing.

  • v0.4 spec: task handoff, status updates, result delivery.

  • Register A2A endpoints in Settings > Integrations > A2A.

  • Supports both synchronous (request/response) and asynchronous (webhook callback) patterns.

Stripe Connect

  • Developer payouts: Stripe Connect Express for marketplace earnings.

  • Payment flow: user confirms price > hold created > agent executes > user confirms result > payment captured.

  • Setup: Developer Portal > Billing > Connect with Stripe.

  • 85% developer share, 15% platform fee. Monthly payouts. 7-day dispute window.