Connectors

What connectors are

WeeAgent connectors are external integrations exposed three ways, all sharing a single server module (_shared/connectors.ts): as WeeAgent tools (the in-app agent), as MCP tools (mcp-server), and as routes of the public API (/v1/connectors/*).

Live connectors (French public APIs, no key)

• fr_companies — French company search (Sirene/INSEE): SIREN, name, NAF, head office, directors.
• fr_address — address geocoding (Base Adresse Nationale): label, postcode, commune, INSEE code, lat/lon.
• fr_communes — communes by name or postal code (geo.api.gouv): INSEE code, population, department, region.
• fr_bodacc — legal announcements (BODACC) for a company by SIREN or free text.

Use from WeeAgent

Enable connectors on the provider — the agent then gets the fr_* tools and can answer questions like « search the company Cabinet Namysl ».

1<WeeAgentProvider bridge={bridge} userName={user.firstName} connectors>
2  <YourApp />
3  <WeeAgentDock title="Copilot" />
4</WeeAgentProvider>

Use via MCP

The mcp-server exposes the same connectors as MCP tools (fr_companies, fr_address, fr_communes, fr_bodacc), consumable by Claude or any MCP client. They resolve to the public-api /connectors/* routes.

Use via the public API

Any consumer with an API token can call them directly (read-only, subscription-gated):

1curl -H "Authorization: Bearer tok_…" \
2  "$SUPABASE_URL/functions/v1/public-api/connectors/companies?q=Cabinet%20Namysl&limit=3"

Catalog & roadmap

src/connectors/registry.ts is the honest catalog. Beyond the live French APIs, it declares: key-based APIs (Pappers, INSEE Sirene, INPI), OAuth integrations (Microsoft 365, Notion, Slack, Zoom), deep-links (Teams, WhatsApp, Office, Légifrance, impots.gouv…), and partner-only editors.