Can I use Exa AI as a CLI?

Yes. KosmoKrator exposes a Exa AI CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Exa AI through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Exa AI tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Exa AI credentials stored?

Exa AI credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Exa AI MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

Exa AI CLI for AI Agents

Use the Exa AI CLI from KosmoKrator to call Exa AI tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

5 functions 5 read 0 write API key auth

Submit Exa AI feedback View package source

Exa AI CLI Setup

Exa AI can be configured headlessly with `kosmokrator integrations:configure exa`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure exa --set api_key="$EXA_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor exa --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`EXA_API_KEY`	Secret `secret`	yes	API Key
`url`	`EXA_URL`	URL `url`	no	Base URL

Call Exa AI Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call exa.exa_search '{
  "query": "example_query",
  "num_results": 1,
  "use_autoprompt": true,
  "type": "example_type",
  "category": "example_category",
  "start_published_date": "example_start_published_date"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:exa exa_search '{
  "query": "example_query",
  "num_results": 1,
  "use_autoprompt": true,
  "type": "example_type",
  "category": "example_category",
  "start_published_date": "example_start_published_date"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs exa --json
kosmo integrations:docs exa.exa_search --json
kosmo integrations:schema exa.exa_search --json
kosmo integrations:search "Exa AI" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Exa AI.

`exa.exa_search`

Read read

Perform a neural search query across the web using Exa AI. Returns a list of relevant pages with titles, URLs, and scores. Supports filtering by category, date range, and autoprompt mode.

Parameters: query, num_results, use_autoprompt, type, category, start_published_date

Generic CLI call

kosmo integrations:call exa.exa_search '{"query":"example_query","num_results":1,"use_autoprompt":true,"type":"example_type","category":"example_category","start_published_date":"example_start_published_date"}' --json

Provider shortcut

kosmo integrations:exa exa_search '{"query":"example_query","num_results":1,"use_autoprompt":true,"type":"example_type","category":"example_category","start_published_date":"example_start_published_date"}' --json

`exa.exa_find_similar`

Read read

Find web pages similar to a given URL. Useful for discovering related content, competitors, or alternative resources. Returns a list of similar pages with titles, URLs, and scores.

Parameters: url, num_results

Generic CLI call

kosmo integrations:call exa.exa_find_similar '{"url":"example_url","num_results":1}' --json

Provider shortcut

kosmo integrations:exa exa_find_similar '{"url":"example_url","num_results":1}' --json

`exa.exa_get_contents`

Read read

Retrieve the full text contents and optional highlights for a list of Exa document IDs. Use this after a search or findSimilar call to get the actual page content.

Parameters: ids, text, highlights

Generic CLI call

kosmo integrations:call exa.exa_get_contents '{"ids":"example_ids","text":true,"highlights":"example_highlights"}' --json

Provider shortcut

kosmo integrations:exa exa_get_contents '{"ids":"example_ids","text":true,"highlights":"example_highlights"}' --json

`exa.exa_search_and_contents`

Read read

Search the web and retrieve full page contents in one call. Combines search and content retrieval into a single request for efficiency. Returns results with both metadata and full text content.

Parameters: query, num_results, use_autoprompt, type, category, start_published_date, text, highlights

Generic CLI call

kosmo integrations:call exa.exa_search_and_contents '{"query":"example_query","num_results":1,"use_autoprompt":true,"type":"example_type","category":"example_category","start_published_date":"example_start_published_date","text":true,"highlights":"example_highlights"}' --json

Provider shortcut

kosmo integrations:exa exa_search_and_contents '{"query":"example_query","num_results":1,"use_autoprompt":true,"type":"example_type","category":"example_category","start_published_date":"example_start_published_date","text":true,"highlights":"example_highlights"}' --json

`exa.exa_get_current_user`

Read read

Get the currently authenticated Exa user's profile information, including email and API usage details. Useful for verifying credentials.

Parameters: none

Generic CLI call

kosmo integrations:call exa.exa_get_current_user '{}' --json

Provider shortcut

kosmo integrations:exa exa_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`exa.exa_search`

Perform a neural search query across the web using Exa AI. Returns a list of relevant pages with titles, URLs, and scores. Supports filtering by category, date range, and autoprompt mode.

Operation: Read read
Schema command: kosmo integrations:schema exa.exa_search --json

Parameter	Type	Required	Description
`query`	string	yes	Natural language search query. Describe the type of content you want to find.
`num_results`	integer	no	Number of results to return (default: 10, max: 100).
`use_autoprompt`	boolean	no	Let Exa automatically optimize your query for better results (default: true).
`type`	string	no	Search type: "keyword" for exact matches, "neural" for semantic search, "auto" to let Exa decide (default: "auto").
`category`	string	no	Filter results to a specific category of content.
`start_published_date`	string	no	Only return results published after this date (ISO 8601, e.g., "2024-01-01T00:00:00Z").

`exa.exa_find_similar`

Find web pages similar to a given URL. Useful for discovering related content, competitors, or alternative resources. Returns a list of similar pages with titles, URLs, and scores.

Operation: Read read
Schema command: kosmo integrations:schema exa.exa_find_similar --json

Parameter	Type	Required	Description
`url`	string	yes	The URL to find similar pages for (e.g., "https://example.com/article").
`num_results`	integer	no	Number of similar pages to return (default: 10, max: 100).

`exa.exa_get_contents`

Retrieve the full text contents and optional highlights for a list of Exa document IDs. Use this after a search or findSimilar call to get the actual page content.

Operation: Read read
Schema command: kosmo integrations:schema exa.exa_get_contents --json

Parameter	Type	Required	Description
`ids`	array	yes	List of Exa document IDs to retrieve contents for.
`text`	boolean	no	Include full page text in the response (default: true).
`highlights`	object	no	Highlight configuration for extracting key passages from the content.

`exa.exa_search_and_contents`

Search the web and retrieve full page contents in one call. Combines search and content retrieval into a single request for efficiency. Returns results with both metadata and full text content.

Operation: Read read
Schema command: kosmo integrations:schema exa.exa_search_and_contents --json

Parameter	Type	Required	Description
`query`	string	yes	Natural language search query.
`num_results`	integer	no	Number of results to return (default: 10, max: 100).
`use_autoprompt`	boolean	no	Let Exa automatically optimize your query (default: true).
`type`	string	no	Search type: "keyword", "neural", or "auto" (default: "auto").
`category`	string	no	Filter results to a specific category of content.
`start_published_date`	string	no	Only return results published after this date (ISO 8601, e.g., "2024-01-01T00:00:00Z").
`text`	boolean	no	Include full page text in the response (default: true).
`highlights`	object	no	Highlight configuration for extracting key passages.

`exa.exa_get_current_user`

Get the currently authenticated Exa user's profile information, including email and API usage details. Useful for verifying credentials.

Operation: Read read
Schema command: kosmo integrations:schema exa.exa_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.