Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.protean.peerislands.io/llms.txt

Use this file to discover all available pages before exploring further.

The full per-provider guides live at docs/integrations/ in the repo. Each follows the four-section template (prereqs / env vars / steps / verify / common failures).

Day-1 OAuth providers

ProviderHelperProgrammatic creation?
GitHubbun run scripts/setup-oauth.ts --provider githubNo (web UI only; URL prefill works)
Googlebun run scripts/setup-oauth.ts --provider googleNo (Cloud Console wizard)
Microsoft 365bun run scripts/setup-oauth.ts --provider o365Yes via az CLI; web fallback

Secrets

WhatHelper
JWT_SECRET + JWT_REFRESH_SECRETbun run scripts/setup-jwt.ts

Outbound integrations (Protean as a server)

HostNotes
Claude Code, Claude Desktop, Cursor, Windsurf, Continue, …See mcp-hosts.md. Same mcpServers config block works across hosts. The exposed tool is companyResearch.run.

Maintenance rule

When adding a new integration: add a per-provider doc, add env vars to .env.example, add a scripts/setup-*.ts helper if feasible. AGENTS.md rule #11 enforces this.