exa

web_search_exa

Read-onlyIdempotent

Search the web for any topic and get clean, ready-to-use content.

  Best for: Finding current information, news, facts, people, companies, or answering questions about any topic.
  Returns: Clean text content from top search results.

  Query tips:
  describe the ideal page, not keywords. "blog post comparing React and Vue performance" not "React vs Vue".
  Use category:people / category:company to search through Linkedin profiles / companies respectively.
  If highlights are insufficient, follow up with web_fetch_exa on the best URLs.

Input Schema

TableJSON Schema

Name	Required	Description
`query`	Yes	Natural language search query. Should be a semantically rich description of the ideal page, not just keywords. Optionally include category:<type> (company, people) to focus results — e.g. 'category:people John Doe software engineer'.
`objective`	Yes	Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.
`numResults`	No	Number of search results to return (default: 10).

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedSep 10, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "query"
-]New value: +[
+  "query",
+  "objective"
+]

Changed2 schema fields changedSep 10, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "query",
-  "objective"
-]New value: +[
+  "query"
+]

Changed2 schema fields changedSep 10, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "query"
-]New value: +[
+  "query",
+  "objective"
+]

Changed2 schema fields changedSep 10, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "query",
-  "objective"
-]New value: +[
+  "query"
+]

Changed2 schema fields changedSep 10, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "query"
-]New value: +[
+  "query",
+  "objective"
+]

Changed2 schema fields changedSep 10, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

changedInput schema / required

Previous value: -[
-  "query",
-  "objective"
-]New value: +[
+  "query"
+]

Changed2 schema fields changedSep 10, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "Goal for this search turn; say which documents should rank first, which should be excluded, and what specific facts or figures to pull from them.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "query"
-]New value: +[
+  "query",
+  "objective"
+]

Changed1 schema field changedSep 9, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedSep 9, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedSep 5, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedSep 5, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedSep 4, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedSep 4, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedSep 3, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedSep 3, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedSep 1, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedSep 1, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 28, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedAug 28, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 27, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedAug 27, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 24, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedAug 24, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 24, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedAug 24, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 13, 2026

removedInput schema / properties / objective

Removed value: -{
-  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
-  "maxLength": 4096,
-  "minLength": 1,
-  "type": "string"
-}

Changed1 schema field changedAug 13, 2026

addedInput schema / properties / objective

Added value: +{
+  "description": "The broader task this search is part of. Always include it when known. It supplements the query rather than replacing it so write the query as you normally would.",
+  "maxLength": 4096,
+  "minLength": 1,
+  "type": "string"
+}

Changed1 schema field changedAug 13, 2026

changedOutput schema / (root)

Previous value: -{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "additionalProperties": false,
-  "properties": {
-    "results": {
-      "items": {
-        "additionalProperties": true,
-        "properties": {
-          "author": {
-            "type": "string"
-          },
-          "highlights": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "publishedDate": {
-            "type": "string"
-          },
-          "text": {
-            "type": "string"
-          },
-          "title": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "searchTime": {
-      "type": "number"
-    }
-  },
-  "required": [
-    "results"
-  ],
-  "type": "object"
-}New value: +null

Changed1 schema field changedAug 13, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "results": {
+      "items": {
+        "additionalProperties": true,
+        "properties": {
+          "author": {
+            "type": "string"
+          },
+          "highlights": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "publishedDate": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "title": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "searchTime": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "results"
+  ],
+  "type": "object"
+}

Changed4 schema fields changedMay 11, 2026
- changedInput schema / properties / numResults / description
```
Previous value: -"Number of search results to return (must be a number, default: 10)."New value: +"Number of search results to return (default: 10)."
```
- removedInput schema / properties / numResults / maximum
```
Removed value: -100
```
- removedInput schema / properties / numResults / minimum
```
Removed value: -1
```
- addedInput schema / properties / query / minLength
```
Added value: +1
```

Changed3 schema fields changedApr 9, 2026

changedInput schema / properties / numResults / description

Previous value: -"Number of search results to return (must be a number, default: 5)"New value: +"Number of search results to return (must be a number, default: 10)."

changedInput schema / properties / numResults / maximum
```
Previous value: -20New value: +100
```

changedInput schema / properties / query / description

Previous value: -"Natural language search query. Should be a semantically rich description of the ideal page, not just keywords."New value: +"Natural language search query. Should be a semantically rich description of the ideal page, not just keywords. Optionally include category:<type> (company, people) to focus results — e.g. 'category:people John Doe software engineer'."

Changed5 schema fields changedApr 6, 2026

removedInput schema / properties / freshness

Removed value: -{
-  "description": "How recent results should be. Only set when recency matters.",
-  "enum": [
-    "24h",
-    "week",
-    "month",
-    "year",
-    "any"
-  ],
-  "type": "string"
-}

removedInput schema / properties / includeDomains

Removed value: -{
-  "description": "List of domains to include in the search. If specified, results will only come from these domains.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

changedInput schema / properties / numResults / description

Previous value: -"Number of search results to return (must be a number, default: 8)"New value: +"Number of search results to return (must be a number, default: 5)"

changedInput schema / properties / numResults / maximum
```
Previous value: -100New value: +20
```

removedInput schema / properties / type

Removed value: -{
-  "description": "Search type - 'auto': balanced search (default), 'fast': quick results",
-  "enum": [
-    "auto",
-    "fast"
-  ],
-  "type": "string"
-}

Changed1 schema field changedMar 26, 2026

removedInput schema / properties / category

Removed value: -{
-  "description": "Filter results to a specific category",
-  "enum": [
-    "company",
-    "research paper",
-    "news",
-    "personal site",
-    "people",
-    "financial report"
-  ],
-  "type": "string"
-}

Changed1 schema field changedMar 24, 2026

changedInput schema / properties / category / enum

Previous value: -[
-  "company",
-  "research paper",
-  "news",
-  "tweet",
-  "personal site",
-  "people",
-  "financial report"
-]New value: +[
+  "company",
+  "research paper",
+  "news",
+  "personal site",
+  "people",
+  "financial report"
+]

Changed1 schema field changedMar 24, 2026

removedInput schema / properties / livecrawl

Removed value: -{
-  "description": "Live crawl mode - 'fallback': use live crawling as backup if cached content unavailable, 'preferred': prioritize live crawling (default: 'fallback')",
-  "enum": [
-    "fallback",
-    "preferred"
-  ],
-  "type": "string"
-}

Changed7 schema fields changedMar 23, 2026

changedInput schema / properties / category / description

Previous value: -"Filter results to a specific category - 'company': company websites and profiles, 'research paper': academic papers and research, 'people': LinkedIn profiles and personal bios"New value: +"Filter results to a specific category"

changedInput schema / properties / category / enum

Previous value: -[
-  "company",
-  "research paper",
-  "people"
-]New value: +[
+  "company",
+  "research paper",
+  "news",
+  "tweet",
+  "personal site",
+  "people",
+  "financial report"
+]

addedInput schema / properties / freshness

Added value: +{
+  "description": "How recent results should be. Only set when recency matters.",
+  "enum": [
+    "24h",
+    "week",
+    "month",
+    "year",
+    "any"
+  ],
+  "type": "string"
+}

addedInput schema / properties / includeDomains

Added value: +{
+  "description": "List of domains to include in the search. If specified, results will only come from these domains.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / numResults / maximum
```
Added value: +100
```
addedInput schema / properties / numResults / minimum
```
Added value: +1
```

changedInput schema / properties / query / description

Previous value: -"Websearch query"New value: +"Natural language search query. Should be a semantically rich description of the ideal page, not just keywords."

Changed1 schema field changedMar 20, 2026

removedInput schema / properties / contextMaxCharacters

Removed value: -{
-  "description": "Maximum characters for context string optimized for LLMs (must be a number, default: 10000)",
-  "type": "number"
-}

Changed1 schema field changedMar 6, 2026

addedInput schema / properties / category

Added value: +{
+  "description": "Filter results to a specific category - 'company': company websites and profiles, 'research paper': academic papers and research, 'people': LinkedIn profiles and personal bios",
+  "enum": [
+    "company",
+    "research paper",
+    "people"
+  ],
+  "type": "string"
+}

Changed2 schema fields changedFeb 3, 2026

changedInput schema / properties / contextMaxCharacters / description

Previous value: -"Maximum characters for context string optimized for LLMs (default: 10000)"New value: +"Maximum characters for context string optimized for LLMs (must be a number, default: 10000)"

changedInput schema / properties / numResults / description

Previous value: -"Number of search results to return (default: 8)"New value: +"Number of search results to return (must be a number, default: 8)"

Changed2 schema fields changedFeb 1, 2026

changedInput schema / properties / type / description

Previous value: -"Search type - 'auto': balanced search (default), 'fast': quick results, 'deep': comprehensive search"New value: +"Search type - 'auto': balanced search (default), 'fast': quick results"

changedInput schema / properties / type / enum

Previous value: -[
-  "auto",
-  "fast",
-  "deep"
-]New value: +[
+  "auto",
+  "fast"
+]

First observedJan 31, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, so the safety profile is well covered. The description adds behavioral context beyond annotations: it explains the return type ('clean text content from top search results'), provides query formulation guidance (describe the ideal page, not keywords), and mentions category filters. It doesn't describe pagination or rate limits, but the annotations cover the key behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections ('Best for', 'Returns', 'Query tips') and front-loads the core purpose. It's slightly longer than strictly necessary, but every section earns its place by providing actionable guidance. The formatting with line breaks and bullet-like structure makes it scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with no output schema, the description does a good job explaining what to expect ('clean text content from top search results') and how to use it effectively. It covers the main use cases, query formulation, category filters, and follow-up strategy. It doesn't mention result count limits or pagination, but the numResults parameter is documented in the schema. The description is complete enough for an agent to call this tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all three parameters thoroughly. The description adds value by reinforcing the query style ('describe the ideal page, not keywords') and explaining the category: syntax ('Use category:people / category:company to search through Linkedin profiles / companies respectively'). This goes beyond the schema's parameter descriptions, which already include similar guidance, but the description's reinforcement is useful.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'Search the web for any topic and get clean, ready-to-use content.' It specifies the resource (web) and the action (search), and distinguishes it from the sibling web_fetch_exa by noting it returns search results and suggesting follow-up with web_fetch_exa for fetching URLs. This is a specific verb+resource pairing that an agent can easily understand.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit guidance on when to use this tool: 'Best for: Finding current information, news, facts, people, companies, or answering questions about any topic.' It also gives query tips and explicitly names the alternative: 'If highlights are insufficient, follow up with web_fetch_exa on the best URLs.' This clearly routes the agent to the right tool for the right situation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All exa tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

web_search_exa

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources