Merge Unified's Exa integration Merge Agent Handler's Exa MCP server

Connect your AI Agents to Exa in minutes

Merge lets you securely connect your agents to Exa and thousands of tools instantly

Start building for free

Read docs

Exa

Learn more about Merge Agent Handler

Available tools

answer

AI-generated answer with web citations. Supports exa and exa-pro models. Optional system prompt and structured output via output_schema (JSON Schema Draft 7).

context

Code-focused search across GitHub, docs, Stack Overflow. Returns code snippets and documentation relevant to the query. Max 100000 output tokens.

get_contents

Extract text, highlights, and summaries from URLs. Supports livecrawl for fresh content. Returns per-URL status tracking for partial failures.

start_research

Start an async deep research job. Returns a researchid to poll with getresearch_status. Models: exa-research-fast (quick), exa-research (balanced), exa-research-pro (most capable).

get_research_status

Poll a research job for status and results. Status: pending, running, completed, failed, canceled. Output available when completed.

search

Semantic/keyword web search. Supports neural, fast, auto, deep, instant types. Filter by domain, date, text, category. Include text/highlights/summaries via contents.

find_similar

Find pages similar to a URL. Same filters as search plus excludesourcedomain. Returns ranked results with optional content extraction.

validate_credential

Validate Exa API key by making a lightweight search call.

create_webset

Create a persistent search collection with enrichments. Define a search query and enrichment configs to extract structured data from results.

list_websets

List websets with cursor pagination. Use cursor from page_info for next page. Returns webset IDs, statuses, and search/enrichment configs.

get_webset

Get webset details by ID including status, search configs, and enrichments. Use list_websets to find valid IDs.

delete_webset

Delete a webset permanently. This cannot be undone. Use list_websets to find valid IDs.

list_webset_items

List items in a webset with cursor pagination. Returns items with URLs, titles, and enrichment results. Use get_webset to verify the webset exists.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Exa MCP server

What is an Exa MCP server?

It’s an MCP server that lets your agents access data and functionality from Exa via tools. Your agents can use these tools to answer questions and provide web citations, perform semantic web searches, run deep research jobs, and more.

Exa offers its own “official” MCP server. You can also use 3rd-party MCP servers from a variety of platforms, including Merge Agent Handler.

How can I use an Exa MCP server?

Here are a few ways you can use the server:

Sales prospecting and account research: Use Exa MCP to pull up-to-date company pages, funding news, leadership changes, tech stack signals, and competitor context to personalize outreach and prepare for calls

Competitive intelligence and market monitoring: Continuously discover competitor launches, pricing changes, messaging shifts, and category trends, then summarize what changed and why it matters for positioning

Customer support and escalation triage: When a customer reports an issue, quickly gather relevant external context like vendor status pages, incident write-ups, changelogs, and known outages to speed diagnosis and comms

Content marketing and SEO research: Find the best-ranking and most-cited sources on a topic, extract recurring headings and questions, and generate an evidence-backed brief for blogs, landing pages, and FAQs

Due diligence for partnerships and vendor selection: Aggregate third-party reviews, security/compliance documentation, outage history, and integration ecosystem info to compare vendors and create a concise recommendation memo

What makes Merge Agent Handler’s Exa MCP server better than alternative Exa MCP servers?

Merge Agent Handler provides additional infrastructure around MCP connectors that improves reliability, security, and observability.

Enterprise-grade authentication and credential management: Agent Handler manages authentication flows for third-party systems and securely stores credentials. Developers do not need to build their own credential handling layer

Built-in security gateway with data loss protection (DLP): All tool inputs and outputs are scanned for sensitive data. Administrators can configure rules to block, redact, or mask information before it reaches external systems

Real-time observability and audit logging: Agent Handler logs every tool call and its underlying API request. These logs are fully searchable and provide a complete audit trail for debugging, monitoring, and compliance workflows

Tool Pack management: Instead of exposing all connectors to every agent, developers can bundle connectors and tools into Tool Packs tailored to specific use cases (e.g., research agents vs. internal productivity agents)

Can I set custom security rules for Exa tool calls in Merge Agent Handler?

Yes, Merge Agent Handler includes a security gateway with data loss protection (DLP) that evaluates tool inputs and outputs before they are sent to third-party systems.

Here are some examples:

Block credential leakage in prompts: Block any Exa tool call if the input contains API keys, tokens, or secrets so an agent can't “accidentally” send credentials out via a search query

Redact PII in outbound queries: If the agent includes customer emails, phone numbers, or other identifiers in an Exa query, automatically redact those fields before the tool call is executed

Mask sensitive data in Exa results: If Exa returns content that includes sensitive strings (e.g., internal IDs or access links), mask them before the output is returned to the agent

Hard-block “high-risk” topics or patterns: Block tool calls that appear to be doing targeted research on private individuals, or that match patterns like “SSN”, “passport number”, or “bank account” style data requests

Require stricter controls for certain agents or tool packs: Only allow Exa tools for approved research tool packs, and block Exa tool calls from agents that are intended to operate strictly on internal systems

Alert on rule violations: Trigger real-time alerts when an Exa tool call violates a rule, so Security or Engineering can review and follow up quickly