pi-exa

Web search, deep research and fetch content tools for Pi Agent, powered by Exa.

Package details

← Back
extension

Install pi-exa from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-exa
Package
pi-exa
Version
0.1.3
Published
May 5, 2026
Downloads
not available
Author
junnjiee
License
MIT
Types
extension
Size
24.1 KB
Dependencies
2 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Exa

Web search, fetching, and deep research for your Pi Agent. Powered by Exa

No API key needed for web search and fetch. Works out of the box, just install it and your agent starts using it.

Why Exa for your Agent

  • Free - 1000 requests/month for web search and fetch, via the Exa MCP server
  • Semantic search - understands intent, not just keyword searches
  • LLM-friendly results - Exa returns clean snippets instead of dumping entire sites that nuke your context window
  • Get what you want - Your agent can make sense of Exa's multiple search filters to get you narrowed results

Install

pi install npm:pi-exa

Optional: Exa API key for the deep search tool. To register your key:

pi /exa-login

Features

Exa MCP

  • Use web search and content fetching with no API key required
  • Toggle paid Exa MCP usage with /exa-mcp-use-api-key on|off
  • Lazy-loaded Exa MCP server that connects on first tool call
  • Cached MCP tool schemas so Pi can register tools during startup even before connecting

Exa Advanced Web Search

  • Let your agent use every Exa search filter
  • Disabled by default to save context (~1200 tokens)
  • Agent-enabled advanced search via enable_web_search_advanced_exa, or manual opt-in with --exa-advanced

Deep Search

  • Give your agent access to Deep Search via the Exa API, with deep-lite, deep, and deep-reasoning modes

Docs

Commands

command description
/exa-login Writes your Exa API key to .pi/agents/auth.json
/exa-logout Removes your API key from .pi/agents/auth.json
/exa-status Shows the Pi Exa extension status
/exa-mcp-use-api-key Uses your API key when calling Exa MCP server. You will be billed. Only use when you've reached your rate limit for free requests

Tools

Enabled by default:

name interface description
web_search_exa Exa MCP Use for general web search
web_fetch_exa Exa MCP Get content of a specific webpage
deep_search_exa Exa API Use for multi-step research or when answer requires synthesis from multiple sources
enable_web_search_advanced_exa None Allows Pi agent to enable web_search_advanced_exa

Disabled by default:

name calls description
web_search_advanced_exa Exa MCP web_search_exa but with all filter parameters available (~1200 tokens to load into context)

Flags

name description
--exa-advanced Enables the web_search_advanced_exa tool by default for this session

Bugs and suggestions

Open an issue!