AVAsk VarroLaunch a pilot

Developer site

Embed Ask Varro where employees already ask for help.

Developer docs for widget setup, tenant-aware auth, approved source ingestion, and webhook-driven operational workflows.

Widget install

Use the embedded web widget as the first supported channel for pilot teams.

<script
  src="https://app.askvarro.com/widget.js"
  data-tenant="your-tenant"
  data-domain="intranet.company.com">
</script>

Auth and access

Requests should preserve tenant context and enforce role-aware access server-side.

Authorization: Bearer <token>
X-Varro-Tenant: <tenant-id>

Quick start

Implementation path for a controlled pilot.

  1. Create a tenant workspace through signup or admin provisioning.
  2. Configure allowed widget domains for the customer site or intranet.
  3. Load approved knowledge sources and confirm answer policy.
  4. Embed the web widget where employees already look for help.

API surface

Reference docs should stay task-oriented and versioned as public APIs stabilize.

Auth

JWT sessions, password reset, tenant selection

Knowledge bases

Sources, files, links, ingestion state

Chat

Question submission, citations, gap handling

MCP

Tenant-scoped tools over Streamable HTTP at /mcp

Webhooks

Outbound events for operational workflows

MCP endpoint

Use JWT auth against the dev API MCP endpoint for tenant-scoped tools.

POST https://dev.api.askvarro.com/mcp
Accept: application/json, text/event-stream
Authorization: Bearer <token>

Guardrails

Keep approved-source behavior, citation display, and fail-closed handling intact.