feat: add Exa AI-powered search tool#308
Open
tgonzalezc5 wants to merge 1 commit intotractorjuice:mainfrom
Open
feat: add Exa AI-powered search tool#308tgonzalezc5 wants to merge 1 commit intotractorjuice:mainfrom
tgonzalezc5 wants to merge 1 commit intotractorjuice:mainfrom
Conversation
Adds the hosted Exa MCP (https://mcp.exa.ai/mcp) alongside the existing AWS Knowledge, Microsoft Learn, Google Developer Knowledge, Data Commons, and govreposcrape servers so ArcKit has coverage for topics the cloud-vendor docs servers don't (vendor discovery, market research, regulatory/news context, general citations). - arckit-claude/.mcp.json: register exa with x-api-key header - arckit-gemini/gemini-extension.json: register exa - arckit-opencode/opencode.json: register exa (enabled: true) - arckit-claude/.claude-plugin/plugin.json: add EXA_API_KEY userConfig (optional; Exa works on the free tier without a key) - docs/guides/mcp-servers.md (and 4 flavor copies): document the server, its three tools (web_search_exa, web_fetch_exa, web_search_advanced_exa), and the optional API-key setup - README.md: list Exa in bundled-MCP summaries - CHANGELOG.md + arckit-claude/CHANGELOG.md: Unreleased entries
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
https://mcp.exa.ai/mcp) in the Claude Code, Gemini CLI, and OpenCode configs, alongside the existing AWS Knowledge, Microsoft Learn, Google Developer Knowledge, Data Commons, and govreposcrape servers.web_search_exa(clean, ready-to-use search results),web_fetch_exa(URL-to-markdown retrieval),web_search_advanced_exa(domain / date-range / highlight / subpage filters).arckit-datascoutagent.EXA_API_KEYentry inplugin.jsonuserConfiglifts rate limits when set.Usage
Once installed, the three Exa tools are available to any ArcKit command/agent that consumes MCP. Examples:
web_search_exa(query: "UK public-sector CRM vendors 2025", num_results: 10)— quick search for vendor/market researchweb_fetch_exa(urls: ["https://example.com/whitepaper"])— fetch a supplier whitepaper as markdown for citation extractionweb_search_advanced_exa(query: "...", include_domains: ["gov.uk"], start_published_date: "2024-01-01")— scoped, date-filtered search for regulatory contextWith the optional key:
Claude Code users can also set the key via the plugin's
userConfigUI; the.mcp.jsonresolves${user_config.EXA_API_KEY}automatically.Files Changed
arckit-claude/.mcp.json— registerexawithx-api-keyheaderarckit-gemini/gemini-extension.json— registerexaarckit-opencode/opencode.json— registerexa(enabled: true)arckit-claude/.claude-plugin/plugin.json— addEXA_API_KEYtouserConfigdocs/guides/mcp-servers.md+ copies underarckit-opencode,arckit-codex,arckit-copilot,arckit-paperclip— document the server, its tools, and optional key setupREADME.md— list Exa in the two bundled-MCP summary lines and the "Why Claude Code?" comparison rowCHANGELOG.md+arckit-claude/CHANGELOG.md—[Unreleased]entriesTest plan
python3 -m json.toolclean on all 5)markdownlint-cli2passes on all edited.mdfiles (matches the repo's existinglint-markdown.ymlworkflow)exaserver shows up in/pluginand thatweb_search_exareturns results without a keyEXA_API_KEY, restart, confirm no error and that advanced features work