Exa

01

Setup

1. 01Create a key. In Exa open dashboard.exa.ai/api-keys and create an API key.
2. 02Paste it. In the superagnt app open Integrations, pick Exa and paste the key.

superagnt_ stores the key encrypted and sends it to Exa as a bearer token on every call.

02

Things to know

• Every Exa call is a POST with a JSON body. superagnt_ forwards the path and body to Exa's API (https://api.exa.ai) with your key attached.
• search and findSimilar take a contents object (text, highlights, summary), so one call can return results together with their contents.
• getContents takes a list of urls. Exa serves pages from its cache and crawls live when a page is not cached; maxAgeHours sets how old a cached page may be.
• numResults is at most 100.
• A 429 from Exa comes back as RATE_LIMITED (HTTP 429). The limit is Exa's, on your key: back off and retry.

03

Examples

Search with contents

curl -X POST "https://api.superagnt.com/v1/connections/exa/search" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest developments in LLMs",
    "numResults": 10,
    "contents": {
      "highlights": { "maxCharacters": 4000 },
      "summary": { "query": "Summarize key claims." }
    }
  }'

Read pages by URL

curl -X POST "https://api.superagnt.com/v1/connections/exa/contents" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://arxiv.org/abs/2410.00001"],
    "text": { "maxCharacters": 8000 },
    "summary": { "query": "What does this paper contribute?" }
  }'

Find similar pages

curl -X POST "https://api.superagnt.com/v1/connections/exa/findSimilar" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://openai.com/blog/",
    "numResults": 10,
    "excludeDomains": ["openai.com"]
  }'

Answer a question with citations

curl -X POST "https://api.superagnt.com/v1/connections/exa/answer" \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Who won the 2025 Nobel Prize in Physics and for what contribution?",
    "text": true
  }'

3 tools, one per resource and risk

MCP servers and agents on the grouped surface list Exa as these tools. Each takes an action, and the ones that work across record types an object. Every operation also keeps its own per-operation name, in the next table, which works on every server. How grouping works: Grouped tools.

All 4 operations

Each operation is a REST path under https://api.superagnt.com/v1/connections/exa and an MCP tool. The per-operation tool name is the one permissions, approvals and usage records use.

Related