Vaquill Integrations

Chatbots, widgets, extensions, MCP servers, and platform connectors for Vaquill AI — the legal research API.

Each integration is self-contained — pick any one, deploy it independently.

Quick Start

All chatbots and widgets use the Vaquill API. You need a Vaquill API key (vq_key_...) from vaquill.ai/dashboard.

git clone https://github.com/Vaquill-AI/integrations.git
cd integrations/<integration-name>
cp .env.example .env   # add your VAQUILL_API_KEY
# follow the integration's README for setup

Chatbots

Integration	Platform	Language	Deploy
whatsapp-bot	WhatsApp (via Twilio)	Python (FastAPI)	Docker / Render
slack-bot	Slack	Python (slack-bolt)	Docker / Heroku
discord-bot	Discord	Python (discord.py)	Docker / Railway
telegram-bot	Telegram	Python (python-telegram-bot)	Docker / Render
ms-teams-bot	Microsoft Teams	Python (botbuilder)	Docker / Azure

All chatbots share the same architecture:

• Vaquill API client (vaquill_client.py) for legal Q&A
• Per-user/channel conversation history (multi-turn)
• Rate limiting (Redis or in-memory)
• Structured source citations from case law
• Slash commands, feedback buttons, analytics

Widgets

Integration	Type	Language	Deploy
widget-next	Embeddable chat (Next.js)	TypeScript	Vercel
widget	Embeddable chat (Docker)	Python + HTML	Docker Compose

Drop-in chat widgets for any website. Embed with a script tag or iframe.

Browser Extension

Integration	Platform	Language
chrome-extension	Chrome / Edge / Brave	JavaScript (Manifest V3)

Chrome extension popup with legal AI chat. Calls the Vaquill API directly.

Automation

Integration	Platform	Format
n8n	n8n / Make.com	Workflow JSON

Pre-built workflow templates for batch legal research via spreadsheets.

MCP Servers

Both MCP servers now live in their own dedicated repositories. Each ships with bring-your-own-key (BYOK) auth so you can use Vaquill's hosted endpoint with your own API key (we never see or store it).

Server	Repo	Hosted endpoint
CourtListener (US)	Vaquill-AI/courtlistener-mcp	https://courtlistener-mcp.vaquill.ai/mcp/
CanLII (Canada)	Vaquill-AI/canlii-mcp	https://canlii-mcp.vaquill.ai/mcp

See each repo's README for client setup (Claude Desktop, Cursor, VS Code, Windsurf, etc.) and self-hosting instructions.

Vaquill API

All integrations use the same simple API:

curl -X POST https://api.vaquill.ai/api/v1/ask \
  -H "Authorization: Bearer vq_key_..." \
  -H "Content-Type: application/json" \
  -d '{"question": "What is Section 302 IPC?"}'

Response:

{
  "data": {
    "answer": "Section 302 of the Indian Penal Code deals with...",
    "sources": [
      {
        "sourceIndex": 1,
        "caseName": "State of UP v. Ram Sagar Yadav",
        "citation": "(1985) 1 SCC 552",
        "court": "Supreme Court of India",
        "excerpt": "...",
        "relevanceScore": 0.94
      }
    ],
    "mode": "standard"
  },
  "meta": {
    "processingTimeMs": 2340.5,
    "creditsConsumed": 0.5,
    "creditsRemaining": 4.5
  }
}

See the API Reference for full documentation.

License

MIT. Each MCP server retains its upstream license — see individual subdirectories.