twenty/packages/twenty-apps/internal/exa

twenty-exa

Exposes Exa structured web search to Twenty AI agents (chat + workflow agents + MCP) as the app_exa_web_search tool.

Installation

1. Register the app on the Twenty server once (admin API / UI): twenty-exa from npm.
2. Set isPreInstalled=true on the registration so it's installed on every new workspace. Existing workspaces can be backfilled via the install-pre-installed-apps CLI command.
3. Set the EXA_API_KEY server variable on the registration to your Exa API key. The value is injected into every logic function execution — no per-workspace configuration needed.

Billing

The handler calls Twenty's generic app billing endpoint (POST /app/billing/charge) using the application access token injected into the execution env. Pricing mirrors Exa's auto-search tier: $0.007 base (10 results) + $0.001 per additional result.